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This publication describes the functions, principal 
features, and use of the Model 20 Card Programming 
Support, Input/Output Control System (CPS IOCS). 
The Model 20 IOCS provides tested input/output 
routines that programmers , by means of macro 
instructions, can use to control the input and 
output of data by programs written in the Model 20 
Basic Assembler Language. 

Included in the publication are sections 
describing the generation of the IOCS routines, 
the definition statements that a programmer uses 
to describe his application to the IOCS, and the 
macro instructions that the programmer uses in his 
main source program when he desires an 
input/output operation to be performed. Also 
included are sections containing program 
performance data and a sample program. 

The programmer should be familiar with the SRL 
publication IBM System/360 Model 20 Card 
Programming Support, Basic Assembler Language, 
Order No. GC26-3602. 
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Fifth Edition (April, 1970) 



This is a major revision of, and obsoletes, GC26-3603-2, -3, 
and Technical Newsletters GN33-8502 and GN33-8524. Minimum 
and maximum machine requirements, as well as Submodel 5 
information, have been added. Further changes and additions 
have, been made throughout this publication. Changes to the 
text, and small changes to illustrations, are indicated by 
a vertical line to the left of the change; changed or added 
illustrations are denoted by the symbol • to the left of the 
caption. 



This edition applies to version 2, modification 1, of IBM 
System/360 Model 20, Card Programming Support, Input/Output 
Control System. The program to which this publication 
applies falls under Programming Service Classification C. 
Therefore, no further centralized maintenance of the program 
or the publication should be expected. 

Requests for copies of IBM publications should be made to 
your IBM representative or to the IBM branch office serving 
your locality. 

Comments concerning the contents of this publication may be 
addresses to IBM Laboratory, Publications Dept. , P.O.Box 24, 
Uithoorn, Netherlands. 
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A major part of most programs written in 
the Basic Assembler language consists of 
routines reguired to read data into the 
system and to output the results of the 
processing performed on the input data. A 
programmer can use the Model 20 IOCS 
routines in his Basic Assembler source 
program by means of macro instructions. 
Programming time is saved because the user 
does not have to code, to test, or to 
provide linkages to his own input/output 
routines. He can concentrate on solving 
his problem and let IOCS handle the 
input/output. In addition, the IOCS 
routines take advantage of the time-sharing 
capability of the Model 20, thereby 
optimizing throughput. 



USE OF THE IOCS 

The user is provided with a complete set of 
input/output routines to perform all 
possible Model 20 input/output operations. 
Not all of these routines need be included 
in every source program because only 
certain types of input/output operations 
may oe required for a given application. 
Therefore, IBM. provides, as part of the 
IOCS, a generator program whose function is 
to select the routines required by the user 
and develop them for his application. This 
procedure minimizes main storage 
requirements because routines and parts of 
routines not required are not generated. 

The generator program first reads 
definition statements made by the user 
describing the input/output operations 
required by the application. Based on 
these statements the generator selects the 
required input/output routines from the 
IOCS routine library, develops them for the 
specific application, and punches them into 
cards in the Basic Assembler source 
language format. These routines can be 
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f separate assembly, the 
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program can contain a 

symbols. 



The IOCS routines are inserted into the 
object program as subroutines. Therefore, 
there must be a linkage to the correct IOCS 
routine from each point in the program 
where an input/output operation is to 
occur. The user need not provide these 
linkages. He only writes one instruction 
(macro instruction) in his source program 
at the point he desires the input/output 
operation to occur. When a macro 
instruction is read during assembly of the 
source program, the Easic Assembler program 
automatically inserts the required linkages 
to and from the IOCS routines. 



IOCS ASSEMBLY 

The deck of cards containing the IOCS 
routines in Basic Assembler symbolic 
language can be assembled either separately 
or in conjunction (jointly) with the Basic 
Assembler source program (Figures 1 and 2). 

Separate IOCS assemoly has two 
significant advantages : 

1. The user needs to assemble the required 
IOCS portion of his program only once 
for any given application. This 
results in significant savings in 
machine time that would otherwise be 
required for reassemblies necessitated 
by changes to the source program. 

2. Separate assembly permits the 
programmer to use nearly the maximum 
number of symbols in his Basic 
Assembler source program. 

If both the IOCS routines and the main 
program are assembled separately, they must 
be assembled in relocatable form. Both 
must be loaded by the relocatable loader, 
but the main program need not be relocated. 
The main program must be loaded first and 
must not contain the name 1001. 
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If the IOCS routines are assembled 
separately, these routines use three 
linkage symbols. Therefore, the programmer 
can use only eleven linkage symbols (EXTRN 
and ENTRY statements) in his main program. 
The IOCS routines require three additional 
linkage symbols if the IOCS is used in 
conjunction with the 1419 IOCS and one 



additional linkage symbol if the IOCS is 
used in conjunction with the CIOCS 
(Communication Input/Output Control 
System) . 

If the IOCS routines and the main 
program are assembled jointly, the main 
source program tiust not contain any 



IOCS Routine Library 



IOCS Generator 
Sections 2-4 



IOCS Definition Cards 
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IOCS Control Card 



/ IOCS Generator 
Section 1 
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Generation 



IOCS Header Deck 








ASSEMBLY 



* Contains provisions for linkage to the main object program. 
** Contains provisions for linkage to the IOCS object program. 



Main ** 

Object Program 



rigure 1. Separate Assembly of IOCS 
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symbolic names that consist of a letter I 
followed by three numeric characters (0-9) 
These symbols may not be used because the 
IOCS uses them. 



The symbolic name assigned to the file 
to be processed by the IOCS routines must 
not be used in the name field of an/ 
statement in the main program. 

To ensure that the base registers used 
in tha main program do not interfere tfith 
the base register assignments for the 
generated IOCS routines, the programmer 
should write DROP instructions for these 



base registers at the end of the main 
program. 



The first 156 bytes of main storage 
(addresses 0-9B) are reserved. The/ are 
not available to the user. 



Machine Requirements 

This section describes the minimum and 
maximum system configurations for 
assembling and executing CPS IOCS routines, 



IOCS 
CTL Card 



Set of IOCS 
Definition Statements 
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Generation Run 
Model 20 
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Routines in 
Basic Assembler 
Language 



jsic Assembler|_ 
CTL Card 



Main Source 
Program in 
Basic Assembler 
Language Without 
an END Card 



Assembly of Main 
Source Program And 
IOCS Routines 
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Object program 
ready for loading. 
Includes IOCS 
routines and all 
required linkages. 



Figure 2. Joint Assembly of IOCS and Main Program 
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MINIMUM SYSTEM CONFIGURATION 
Submodel 2 

• an IBM 2020 Central Processing Unit, 
Model B2 (4096 bytes of main storage); 

• one of the following card units; 

IBM 256 Multi-Function Card Machine, 
Model hi, 

IBM 252 Card Read-Puncn, Model Al f 
IBM 2501 Card Reader, Model Al or A2, 
witn either an IBM 2520 Card Punch, 
Model A2 or A3, or an IBM 1442 Card 
Punch, Model 5; 

• one of the following printers: 

IBM 1403 Printer, Model (Ml, 2, or 7, 
IBM 2203 Printer, Model Al. 

Subiriodel_3 

• an IBM 2020 Central Processing Unit, 
Model B3 (4096 bytes of main storage); 

• an IBM 2560 Multi-Function Card Macnine, 
Model A2; 

• an IBM 2203 Printer, Yiodel A2 . 
3ubraodel_4_ 

• an IBM 2020 Central Processing Unit,.. 
Model B4 (4096 bytes of main storage). 

Same card unit and printer as for the 
Submodel 3 . 

Submodel_5_ 

• an IBM 2020 Central Processing Unit, 
Model 25 (8192 bytes of main storage). 

Same card units and printers as for the 
Submodel 2 . 



MAXIMUM SYSTEM CONFIGURATION 
Submodel_2 

• an IBM 2020 Central Processing Unit, 
Model D2 (16,384 bytes of main storage); 

• an IBM 1442 Card Punch, Model 5; 

• an IBM 2501 Card Reader, Model Al or A2 ; 

• one of the following card units : 
IBM 2520 Card Read-Puncn, Model Al , 
IBM 2520 Card Punch, Model A2 or A3, 
IBM 2560 Multi-Function Card Machine, 

Model Al; 

• one of the following printers: 

IBM 1103 Printer, Model lMI, 2, or 7, 
IBM 2203 Printer, Model Al; 
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Su^Tiodel_3 

• an IBM 2020 Central Processing Unit, 
Model D3 (16,384 bytes of main storage); 

• an IBM 2560 Multi-Function Card Machine, 
Model A2; 

• an IBM 2203 Printer, Model A2 . 
Submodel 4 

• an IBM 2020 Central Processing Unit, 
Model D4 (16,384 bytes of main storage) . 

Same card unit and printer as for tae 
Submodel 3. 

3ubmodel_5 

• an IBM 2020 Central Processing Unit, 
Model D5 (16,384 bytes of main storage). 

Same card units and printers as for the 
Submodel 2 . 



DEFINITIONS 

This section contains definitions of terra; 
used in this Duplication. 



Record 

A record is one unit of information read Dr fj 
punched or printed by one input/output \_,- 
operation. (Model 20 IOCS can process only 
fixed-length unblocked records.) 



File 

For purposes of Model 20 IOCS, a file is 
the total collection of information 
contained in: 

1. All records passed through a given oard 
feed of a punched-card device. 



2. All records printed as one list during 
the execution of a given program. 

Files can be of two types: simple or 
combined . 



Simple_File. A simple file is a file wriose 
records are all either (1) read, or (2) 
punched, or (3) printed on an output 
printer during one pass through the s/stem. 

Comb ine d_ Fi 1 e . A combined file is a file 
consisting of records, some or all of */nich 
will be read and/or punched during one paso 
through the system. (jee the section ine 
£KE. E F L E _E n. t r y_ ._ ) 
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Overlap Mode is a mode of operation during 
which execution of input/output operations 
and processing are performed simulta- 
neously. 

Definition Statements 

The programmer must use definition 
statements to describe to the IOCS 
generator the characteristics of each file 
to be processed. Definition statements are 
used to assign a name to each of the user's 
input/output files, to describe the 
input/output unit used for each file, to 
define the input/output areas required, 
etc. 

The definition statements are written in 
symbolic form on the IBM System/360 
Assembler Short Coding Form (Form X2 8-6506) 
shown in Figure 3. The statements are 
punched into cards and become the input to 
the IOCS generator. The generator reads 
the statements and, based on the 
information in them, selects the routines 
required for the user's particular 
application. 

The user must write one DTFSR definition 
statement for each file to be used by the 
program. The group of DIFSR statements for 
the files to be processed by a program must 
be followed by a DTFEN terminating 
statement (see DTFEN Terminating 
Statement) . 

DTFSR DEFINITION STATEMENT 

A DTFSR statement consists of one header 
entry and a number of detail entries. The 



number of detail entries depenis on tie 
application. The detail entries may be 
written in any order within a DTFSR 
statement. 



With the exception of the last detail 
entry card in each DTFSR statement, eaca 
header entry card and each detail entry 
card must have a continuation character 
(other than blank) punched in column 72. 
The terminating statement card must not 
have a continuation character in column 72. 



HEADER ENTRY 

The header entry 
the name field a 
operation field 
these entries mu 
entry must be th 
definition state 
the name field o 
be assigned to a 
program. This a 
separate assembl 



consists of an entry in 
nd an entry (DTFSR) in the 
(columns 32-36). Both of 
st be provided. The leader 
e first entry of each 
tnent . The name entered in 
f the header entry must not 
ny statement in the main 
pplies to both joint and 

y- 



The name of the file is specified in the 
name field beginning in column 25. It nay 
consist of up to four characters. The 
first character must be alphabetic , tie 
remaining three characters may be 
alphabetic or numeric. Special characters 
or embedded blanks must not be used. This 
name is used in macro instructions to refer 
to this file. 
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Figure 3. Basic Assembler Short Coding Form 



The entry in the operation field mast be 
DTFSR for all files. Figure 4 shows the 
header entry for a file named INPT. 

r t t 1 

| Name (Operation (Operand | 

j. f 1 ., 

j INPT | DTFSR | j 

U J X . J 

Figura 4. DTFSR Header Entry 



DETAIL ENTRIES 



xhe detail entries are used to define such 
information as the device to be used, the 
mode of processing, etc. Each detail entry 
is composed of a keyword immediately 
followed by an equal (=) sign which, in 



turn, is followed oy one specification. A 
comma must immediately follow the 
specification of each detail entry except 
the last entry written for each DTFSR 
statement. 



All detail entries must be written 
beginning in column 38 on the Short Coding 
f orn . Colunns 25 through 37 on this form 
remain blank. A given detail entry may be 
used only once in each DTFSR statement. 
Entries that do not apply to a given 
application tiust be omitted. 

me detail entries can be divided into 
five categories: 

1. Entries applicable to most files. 

2. Additional entries for simple files. 
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3. Additional entries for combined files. 

4. Additional entries for card printing. 

5. Additional entries that can be used to 
specify certain checking functions. 



DETAIL ENTRIES FOR MOST FILES 

The detail entries applicable to most files 
are : 

DEVICE 

TYPEFLE 

bvORKA 

PRINTOV 

OVERLAP 

CONTROL 

BINARY 

EOFADDR 

Tne DEVICE, TYPEFLE, and WORKA entries 
mast be provided for each file to be used 
by the program. 

The PRINTOV, OVERLAP, CONTROL, BINARY, 
and EOFADDR entries must be provided only 
for certain files to be used by the 
program . 

The PRINTOV entry must be provided for a 
printer file if a PRTOV macro instruction 
referring to the file is used in the main 
source program. 

The OVERLAP entry must be provided for 
all files to be processed in the 
non- overlap node. 

The CONTROL entry must oe provided for a 
file only if a CNTRL macro instruction 
referring to that file is used in the main 
source program. 

The BINARY entry must be provided for 
input files that are to be read in the 
column binary mode. 

Tne EOFADDR entry must be provided for 
all simple input and combined files. 

The DEVICE Entry 

This entry identifies the device (or device 
part) by means of which the file is to be 
read and/or puncned, or printed. 

The entry consists of the keyword DEVICE 
and a specification that identifies tne 
device used by the file. The following 
specifications are provided: 

READ01 file is read by an IBM 2501 
Card Reader 

PUNCH20 file is punched by an IBM 2520 
Card Punch 



PUNCH42 file is punched by an IBM 1442 
Card Punch, Model 5 

PRINTER file is printed by an IBM 22 03 
Printer, with the standard 
carriage, or by an IBM 1403 
Printer. (Refer to Note 
below. ) 

PRINTLF file is printed on the loiter 
carriage of an IBM 2203 witn 
the dual feed carriage. (Refer 
to Note below. ) 

PRINTUF file is printed on the upper 
carriage of an IBM 2203 with 
the dual feed carriage. (Refer 
to Note below.) 

MFCM1 file is read and/or punchad 
from the primary feed of the 
IBM 2560 Multi- Function Card 
Machine. 

MFCM2 file is read and/or punched 

from the secondary feed of the 
IBM 2560 Multi- Function Card 
Machine. 

CRP20 file is read and/or punched by 
the IBM 2520 Card Read Punch. 



Note: If both 
feed carriage 
write a DTFSR 
printed by the 
statement for 
carriage. If 
one feed of th 
lower feed mus 
DEVICE=PRINTER 
DEVICE=PRINTLF 
the print file 



feeds of a 2203 Printer dual 
are used, the programmer must 
statement for the file 

lower carriage and a DTFSR 
the file printed by the upper 
the application requires only 
e dual feed carriage , tie 
t be used. In this case, the 

entry and not the 

entry must be provided in 

DTFSR statement. 



Figure 5 shows an example of the DEVICE 
detail entry identifying a file read by the 
2501 Card Reader . 

r~' t t 1 

| Name J Operation | Operand | 

j. + 1 i 

j | |DEVICE=READ01 f j 

L L X_. . J 

Figure 5. DEVICE Detail Entry 



Ihe_TYPEFLE_Entry_ 

This entry indicates whether the file is an 
input, an output, or a combined file. 

The keyword of this entry is TYPEFLE. 
The allowable specifications are: 

INPUT for a simple input file 
OUTPUT for a simple output file 
CMBND for a combined file. 
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Figure 6 shows an example of the TYPEFLE 
I detail entry. 

r t t n 

| Name | Operation | Operand | 

|. x f \ 

| | |TYP£FLE=Il>IPUT, I 

L X- J J 

• Figure 6. TYPEFLE Detail Entry 

The WORKA Entry 

This entry indicates that a work area is 
specified as the second operand of each 
PUT, SET, or CxRDPR macro instruction 
referring to the file which is always the 
case in Model 20 IOCS. 

The keyword of this entry is wORKA. The 
specification is YES (Figure 7) . 

r 1 1 1 

| Name (Operation | Operand | 

j. x x .( 

| | |rfORKA=iTES, | 

L J J J 

Figura 7. WORKA Detail Entry 

lne name of the work area used ny an/ 

macro instruction is specified in that 

particular instruction and not in the WORKA 
entry for the file. 

Work Area Considerations 

The following considerations apply to the 
use of: input/output areas as work areas for 
files being processed in the overlap and 
the nonoverlap modes. 

2ZISMP_M225i. Input and/or output areas of 
files being processed in the overlap mode 
may not be used as work areas. During 
processing, a given record is processed in 
the work area while other records are 
simultaneously being read into an input 
area or being punched or printed from an 
output area. 

NOjNO\/ERLAP_MODE. For combined files, only 
the punch areas may also be used as work 

areas. 

For simple files, either the input or 
the output area may be used as a work area. 

Card print areas may never be used as 
work areas. 



The PRINIDV Entry 

This entry must oe provided if a PRTOV 
macro instruction referring to tnis printer 
file is used in the main source program. 



The keyword of this entry is PRINTDV. 
The specification is YES (Figure 8). 

r T t 1 

| Name (Operation | Operand | 

j. x x j 

| I j PRINTOV=YES f | 

L . X J J 

Figure 8. PRINTOV Detail Entry 



Th^_OVERLAP_Entry 

This entry specifies that the file is to be 
processed in the nonoverlap mode. If this 
entry is omitted, the file is processed in 
the overlap mode. 

The keyword of this entry is OVERLAP. 
The specification is NO. 

Printer files are always processed in 
the overlap mode. Therefore, an OVERLAP=NO 
entry is not permitted for tnese files. 

Figure 9 shows an OVERLAP entry. 

r t t 1 

| Name (Operation | Operand | 

± x x .j 

| | | OVERLAP=NO, | 

L X . J J 

Figure 9. OVERLAP Detail Entry 



The CONTROL Entry 

This entry must be provided if a CNTRL 
macro instruction referring to this file is 
used in the main source program. 

The keyword of this entry is CONrROL. 
The specification is YES (Figure 10) . 

r -t t 1 

| Name (Operation | Operand | 

|. x x .j 

| ( |CONTROL=YES, | 

L X X _ J- 

Figure 10. CONTROL Detail Entry 

Ihe_EINARY_Entry 

This entry indicates that the cards of an 
input file are to oe read in the column 
binary mode by a Model 2 equipped with the 
Read Column Binary Special Feature. Tha 
entry may be provided for both simple and 
combined input files. 

The keyword of this entry is BINARif. 
The specifications are: 

5TES for simple files 
INPUT for combined files. 
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Figure 11 shows an example of a BINARY 
detail entry. 

r t t 1 

| Name (Operation | Operand | 

j. x x ., 

| | | BINARY=INPUT, | 

L X X J 

Figure 11. BINARY Detail Entry 

Ths twelve punch positions of a card 
column read in column binary mode are 
stored in the 6 low-order bits of two 
adjacent bytes of the input area. 
Therefore, the input and work areas for 
this file must be specified to contain a 
number of bytes that is equal to twice the 
number of card columns to be read. 

When the entry BINARY is used, the 
following detail entries must not be used: 

SEQNCE 

PFORMTn 

RFORMTn 

The EOFADDR Entry 

This entry is used to specify the name of 
the user's end-of-file routine in the main 
program. The entry is mandatory for input 
and combined files. 

The keyword of this entry is EOFADDR. 
The specification is the name of the user's 
end-of-file routine. An example of this 
type of entry is shown in Figure 12. 

r t T 1 

| Name (Operation (Operand | 

L— X X ., 

| | |EOFADDR=END, ( 

I 1 1 J 

Figure 12. EOFADDR Detail Entry 

All card files, on which simple input or 
combined input/output operations will be 
performed, must be terminated by four 
end-of-file cards containing the entry /* 
in the first two columns. A oranch occurs 
to the user's end-of-file routine after the 
first end-of-file card of the corresponding 
file has been read. 

ADDITIONAL DEIAIL ENTRIES FOR SIMPLE FILES 

The entries described in this section are 
available for simple files only. One or 
more of these entries may be required for a 
given file. 

The detail entries are: 

I0AREA1 
IOAREA2 
BLKSIZE 



The I0AREA1 Entry 

This entry defines the name of the 
input/output area to be used by a simple 
file . 

The keyword of this entry is I0AREA1. 
The specification is the name of the input 
or output area used by the file. This name 
must be the symbol used by the programmer 
in defining the area in his main program. 

Figure 13 shows an example of an IDAREA1 
entry. 

r t t 1 

| Name (Operation | Operand | 

L X X ., 

| C |I0AREA1=INP1, | 

L X J J 

Figure 13. I0AREA1 Detail Entry 

Printer Files 

The IOAREAl entry must not be provided for 
a file printed by the standard carriage 
because IOCS uses the print buffer in main 
storage (first 144 positions). Tnis area 
cannot be used by the programmer. 

Two files printed by the dual feed 
carriage require two IuAREAl entries, i.e., 
one for each file. The print areas for the 
lower and upper feed of the dual feed 
carriage must be defined as contiguous 
areas in main storage with the print area 
for the lower- feed carriage preceding the 
area for the upper-feed carriage (Figure 
14). 



| Lower-feed 
| Print Area 

l 

t 

I 

| Address of 

| Lower-feed Area 



i. 



| Upper-feed 
(Print Area 
.j 

t 

I 

| Address of 
Upper-feed Area 



Figure 14. Print-Area Format for Dual Feed 
Carriage 

The I0AREA2 Entry 

This entry can be used to define the name 
of a second input area when the IBM 25 01 
Card Reader is used in the overlap mode. 
This permits a card to be read into tie 
area specified in the DTFSR entry IOAREAl 
while the data in the area specified in the 
DTFSR entry IOAREA2 (from the preceding 
card) is waiting to be moved into the work 
area. This may be of significance if, for 
example, only a number of selected cards of 
the file that is read on the IBM 2 501 
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require extensive process 
other cards require very 
one input area is specifi 
a card that requires exte 
may have to be held avail 
a period of time to pertni 
feeding. In the majority 
specifying a second input 
IOCS to maintain the maxi 
speed of the IBM 2501. 



ing while all 
little. If only 
ed, the data from 
nsive processing 
able for too long 
t continuous card 

of cases, 

area permits the 
mum card reading 



This entry must not be used for a file 
being read or punched by any other input or 
output device or when the 2501, iy odel A2, 
is used in nonoverlap mode. 

Tha keyword of this entry is IOAREA2. 
The specification is the name of the second 
read area as defined in the main program. 
This area must be the same length as the 
first read area whose name is defined in 
the IOAREAl entry. 

Figure 15 shows an example of an IOAREA2 
entry in conjunction with an I0AREA1 entry. 

r t t 1 

| Name (Operation | Operand | 

j. x x 4 

| | | I0AREA1=ARA1, | 

| | |IOAREA2=ARA2, | 

l X . X J 

Figure 15. I0AREA1-I0AREA2 Detail Entry 
Combination 

^he_BLKSIZE_£;ntry_ 

Ihis entry specifies the length of the 
input or output area(s) required by the 
simple file. The length specified in tnis 
entry applies to the area(s) reserved in 
the main program and referred to in tne 
corresponding IOAREA1 entry or IOAREAl- 
I0AREA2 combination. In the case of a 
printer file -- even if an IOAREAl entry is 
not provided -- the BLKSIZE entry must be 
given. 



the number cf print 
positions available. If a 
220 3 printer with a dual 
carriage feature is used, 
the total length of areas 
specified for both feeds 
must oe equal to or less 
than 144 bytes. 

The minimum record lengths acceptable to 
the IOCS is two bytes (four bytes for 
column binary mode) . 

r t t 1 

| Name | Operation | Operand | 

j. X x < 

| | |I0AREA1=INP1, | 

| | |IOAREA2=INP2, j 

| | |BLKSIZE=65, j 

L X X _J 

Figure 16. IOAREAl- 10 AREA 2 Detail Entries 
with BLKSIZE Entry 



ADDITIONAL DETAIL ENTRIES FOR COMBINED 
FILES 

The entries described in this section must 
be provided for each combined file. They 
are: 

INAREA 
INBLKSZ 
00" AREA 
0UBLKSZ 

The INAREA Entry 

This entry specifies the name of the input 
area to be used by the combined file. 

The keyword of this entry is INAREA. 
The specification is the name of the input 
area used by the file. This name must be 
the symbol used by the programmer in 
defining the area in his main program 
(Figure 17). 



Tne keyword of this entry is BLKSIZE. r T T t 

The specification is the length of the | Name (Operation (Operand | 

input/output area in bytes. In the case of j- -j -j- -j 

an IOAREAl- 10 AREA2 combination, the j j | INAREA=INPC, j 

specified length is the length of the L ■*> J- J 

individual fields. 

Figure 17. INAREA Detail Entry 
Figure 16 shows a set of area definition 
entries and a BLASIZE entry for a card file The_INELKSZ_Entry 
requiring two read areas of 65 characters 
each. This entry specifies the length of the 

input area required by the combined file. 
Maximum record lengths acceptable to the The length specified in this entry is that 
IOCS are as follows: of the area reserved in the main program 

and referred to in the INAREA entry. 
For cards: 80 bytes (160 bytes for 

column binary mode). The keyword of this entry is INBLKSZ. 

For printers: 120, 132, or 144 The specification is the length of the 

characters, depending on input area in bytes. 



I 
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Figure 18 shows an INAREA entry and its 
associated INBLKSZ entry specifying an 
input area named INPC that is 65 characters 
in length. 

r t t 1 

| Name | Operation | Operand | 

j. x x ] 

| | |INAREA=INPC, J 

| J | INBLKSZ =6 5, | 

L X X J 

Figure 18. INAREA Detail intry with 
INBLKSZ Entry 

The maximum record length permitted is 
80 bytes (160 bytes for column binary 
mode) . The minimum record length permitted 
is two bytes (four bytes for column binary 
mode) . 



The_oy.AREA_Entry 

This entry specifies the name of the output 
area to be used by the combined file. 

Tha keyword of the entry is OUAREA. The 
specification is the name of the output 
area used by the file. This name mast be 
the symbol used by the programmer in 
defining the area in his main program 
(Figure 19) . 

r t t 1 

| Name | Operation | Operand | 

t x x \ 

| | |OUAREA=OUPC, | 

L . X X : J 

» Figure 19. OUAREA Detail Entry 

Thie-OUBLKSZ^ntry 

This entry specifies the length of the 
output area required by the combined file. 
The length specified in this entry is that 
of the area reserved in the main program 
and referred to in the OUAREA entry. 

The keyword of this entry is OUBLKSZ. 
The specification is the length of tha 
output area in bytes. 

Figure 20 shows an OUAREA entry and its 
associated OUBLKSZ entry specifying an 
output area named OUPC that is 65 
characters in length. 

r t t 1 

| Name (Operation (Operand | 

j. x x _ 4 

| | | OUAREA=OUPC , | 

| | |OUBLKSZ=65, ( 

L X X J 

• Figure 20. OUAREA Detail Entry with 
OUBLKSZ Entry 



The maximum record length permitted is 
80 bytes. The minimum record length 
permitted is one byte. 



ADDITIONAL DETAIL ENTRIES FOR CARD PRINTING 

The following detail entries are required 
only if the card print feature of the &FC.VI 
is to be used: 

3RDPRA 
CRDPRLn 

rne entries described in this section 
can apply only to a simple or combined file 
of the 2560 MFCM. 

The programmer must make the card print 
detail entries only in one DTFSR statament 
of any one program. Tnus, even if he 
intends to perform card printing on cards 
fed by both the primary and the secondary 
feed of the MFCM, he must make tha required 
detail entries in only one of his DrFSR 
statements . 

It is immaterial in which DTFSR 
statement the entries appear, since card 
printing is a function of the CRDPR macro 
instruction (which does not refer to a 
file). For details, see the section 
describing that macro instruction. 

This entry specifies the name of tha araa 
in main storage where the data to ba 
printed by the lowest-numbered MFCM print 
head is stored. 

The keyword of this entry is CRDPRA . 
The specification is the name of tha araa. 

Figure 21 shows a CRDPRA detail antry. 

r " — t t i 

J Name (Operation | Operand | 

j. x x 1 

j | |CRDPRA=CPAR, | 

I .-X X J 

» Figure 21. CRDPRA Detail Entry 

Card_Print_Areas 

The areas containing the data to be printed 
by the MFCM print heads must ba dafinad as 
a contiguous area in main storage. Tie 
whole card print area may be located 
anywhere in main storage, but the areas for 
the individual print heads used must be 
defined within the whole area in ascending 
order of the print head numbers (Figure 
18). 

As shown in Figure 22, the beginning of 
successive individual print araas must be 
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separated by exactly 64 bytes of main 
storage. The length of each print area is 
defined by the corresponding CRDPRLn entry 
(see description of that entry below). 



During each card print operation, each 
print head prints the number of positions 
specified for the longest print area. 
Therefore, if CRDPRLn entries specify card 
print areas of 20, 40, and 50 bytes, 50 
bytes 'of information will be printed from 
each area. 



The programmer may use any unused 
portion of the individual print areas. 
Thus, if the maximum specified card print 
area length is 50 bytes, the last 14 bytes 
in each area may be used for processing. 



In each of the three defined print areas 
shown in Figure 22, an area corresponding 
to the maximum CRDPRLn entry (length A) 
will be printed. Only the shaded areas may 
be used by the programmer for purposes 
other than printing. 

Lengths A, B, and C are defined by 
their respective CRDPRLn entries. 

CPAR 



r T 1 

| Name | Operation | Operand 



a .^.T~T ~"^cl 



64 bytes 64 bytes 64 bytes 

Figure 22. MFCM Card Print Areas 

The CRDPRLn Entry 

This entry defines a print head number and 
the length of the area in main storage 
where the data to be printed by this head 
is stored. A CRDPRLn entry must be 
included for each print head to be used. 



|CRDPRA=CPAR, 
|CRDPRL1=5 0, 
|CRDPRL2=4 0, 
|CRDPRL5=20, 
.X 



Figure 23. CRDPRA Detail Entry with 
CRDPRLn Entries 

Refer to the example in Figures 2 2 and 
23. In this example, print head 1 is to 
print the first 50 bytes of its 64 -byte 
print area (part A) , print head 2 is to 
print the first 40 bytes of its 64-byte 
print area, and print head 5 is to print 
the first 20 bytes of its 64-byte print 
area. However, all three print heads will 
print the first 50 bytes of their 64-byte 
print areas. Therefore, the 64-byte print 
area for print head 2 in the exampla must 
contain blanks in bytes 41 through 50. 
Likewise, all bytes up to and including 
byte 5 of the 6 4-byte print area assigned 
to print head 5 must contain blanks if no 
printing is desired from print head 5 
during a card print operation. 

The programmer need not be concerned 
about filling the unused byte positions of 
a print area with blanks as this is an 
automatic function of the IOCS. If, as in 
our example, 50 bytes is the largest number 
of bytes specified for one particular print 
head, the IOCS clears all print areas up to 
and including byte 50 to blanks after every 
card print operation. 

Specification of the number of bytes to 
be printed by each individual print head is 
required because, when filling a print area 
with data to be printed, the IOCS moves 
into the print area only the numbs r o£ 
bytes specified for the particular print 
head . 



ADDITIONAL DETAIL ENTRIES FDR CHECKING 
FUNCTIONS 






The keyword of this entry is CRDPRLn, 
where n is the number of the print head 
used. The specification is the length (in 
bytes) of the print area containing the 
data to be printed by this print head. 



Figure 23 shows the CRDPRA and CRDPRLn 
entries referring to the print areas shown 
in Figure 22. The entries in Figure 23 
assume that area A is 50 bytes, area B is 
40 bytes, and area Z is 20 bytes in length, 



The following additional detail entries are 
available for card processing to enable the 
user to specify certain checking functions: 

SEQNCE 

3EQXIT 

RFORMIn 

RFXIT 

PFORMTn 

PFXIT 

The SEQNCE Entry 

This entry enables the programmer to check 
whether the contents of a specified field 
in successive input records are equal or in 
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ascending order. If a sequence error is 
found, the program brandies to a 
user-written routine. (The branch address 
is specified by the SEQXII detail entry.) 
Only one SEQNCE entry is permitted for each 
file. 



The sequence check is made by means of a 
logical compare operation. If the input 
data is to be read in the column binary 
mode, a SEQNCE entry may not be made for 
this file. 



The keyword of this entry is SEQNCE. 
The specification is: 



xxyy 



where xx and yy are the numbers of the 
first and last card columns, 
respectively, containing the card 
field to be checked. For card 
columns 1-9, the leading zero must 
be punched. The card field to be 
checked must not be longer than 16 
columns . 



Before branching to the user's routine, 
the IOCS places the record containing the 
field that led to the error condition into 
the work area. If the error card was read 
by the 2560 MFCM or the 2520 Card Read 
Punch, it is positioned at the pre-punch 
station. The next record will be read by 
the next 3EI or EOM (Enter Overlap Mode) 
macro instruction. (Refer to the appro- 
priate sections under The IOCS Macro 
instructions f° r descriptions of GET and 
EOM.) This record will be compared tfith 
the record that preceded the card that led 
to the error condition. 



If the input cards are read in overlap 
mode from either an IBM 2520 or an IBM 
2560, a sequence error with a subsequent 
branch to the user-specified SEQXIT routine 
causes the IOCS to change the processing 
mode (from overlap to nonoverlap) for the 
SSI macro instruction that detected the 
error. 



This change of the mode of operation 
enables the user to stacker-select the 
error card and/or to cause an error 
identification to be punched into this 
card. 

Figure 24 shows an example of a SEQNCE 
entry. This entry specifics that the 
contents of card columns 9-15 are to be 
used for sequence checking. 



r t t i 

| Name | Operation | Operand | 

j. + + .J 

| | |SEQNCE=0915, | 

L J. J J 

Figure 24. SEQNCE Detail Entry 

The SEQXIT Ent ry 

This entry must be used in conjunction with 
the SEQNCE detail entry to furnish the IOCS 
with the name of the user's routine to 
whicn control is to be transferred if a 
sequence error occurs. 

The keyword of this entry is SEQXIT. 
The specification is the name of the user's 
routine. Figure 25 shows an example of a 
SEQXIT entry. 

r t t 1 

| Name (Operation | Operand | 

|. + + < 

| | |SEQXIT=NAME, | 

L J. J J 

Figure 25. SEQXIT Detail Entry 



The RFORMTn ...Entry 



This entry enabl 
that a specified 
contain (s) numer 
blanks. If the 
contain numeric 
program branches 
(if the branch a 
RFXIT detail ent 
data is to be re 
mode, an RFORMTn 
this file. 



es the programmer to check 

input card field or Fields 
ic characters or all 
field is found not to 
characters or blanks, the 

to a user-written routine 

ddress is specified by the 

ry) or halts. If the input 

ad in the column binary 

entry may not be made for 



The keyword of this entry is RFORMTn 
where n is any number from to 9. The n 
position provides the programmer with tne 
possibility of writing a maximum of ten 
different RFORMTn entries and thus having a 
maximum of ten fields checked. The 
specification for this entry is: 

xxyyz 

where xx and yy are the numbers of tie 
first and last card columns, 
respectively, containing tne field 
to be checked (for column 1-9, the 
leading zero must be punched) , and 
z is (check for blanks) or 
1 (check for numeric characters). 

Card fields that are to be checked for 
numeric contents must not be longer than 16 
columns. 

tfhen a field is tested for all blanks, 
control is transferred to a user-written 



Card Programming Support Input/Output Control System 17 



routine when the test fails (i.e.., the 
field is not blank) . 

When a field is tested for numeric 
characters, the test fails if the field 
contents are not of the following format 
(where at least the last character is 
numeric with or without sign): 



where 



bbb. . . nnnnn 

b = blank 

n = numeric character. 



Before branching to the user's routine, 
IOCS places the record containing the field 
that led to the error condition into the 
work area. If the error card was read by 
the 2560 MFCM or the 2520 Card Read Punch, 
it is positioned at the pre-punch station. 
Ihe next record will be read by the next 
GEI or EOM macro instruction. 

If the input cards are read in overlap 
mode from either an IBM 2520, or an IBM 
2560, an RFORMT error with a subsequent 
branch to the user-specified RFXIT routine 
causes the IOCS to change the processing 
mode (from overlap to nonoverlap) for the 
GET macro instruction that detected the 
error. 

This change of the mode of operation 
enables tne user to stacker-select the 
error card and/or to cause an error 
identification to be punched into this 
card. 

Figure 26 shows an example of an RFQRMTn 
entry specifying that columns 73-80 of 
eachcard in the file are to be checked for 
the presence of blanks. 

r t ■ t 1 

j Name | Operation \ Operand j 

j. x x _ ____ „__.j 

| | | RFORM10=73800, j 

I X X . . . .J 

Figure 26. RFORMTn Detail Entry 

If a SEQNCE error and an RFORMTn error 

are ooth detected in the same card , only 

the action specified for the SEQNCE error 
will be performed. 

The programmer may use a maximum of ten 
RFORMTn entries to perform checks on 
different card fields. However, he may use 
only one RFXIT entry for each file. 

Ihe_RFXII_Entry 

This entry is used in conjunction with the 
RFORMTn detail entry to specify the name of 
the user's routine to which control is to 
be transferred if the test made on the 
field specified by means of an RFORMTn 



entry is negative (i.e., if a field is 
found to contain cnaracters other than 
those specified) . 

If this entry is omitted and the test is 
negative, the machine halts. This enables 
the operator to replace the card that led 
to the error condition. 

Figure 27 shows an example of an RFXIT 
entry. 

r~ t T" • ■ —.--.. , 

J Name (Operation | Operand j 

| | jRFXIT=FERR, | 

L X J „ , . J 

Figure 27. RFXIT Detail Entry 
The PFORMTn Entry 



The PFORMTn entry enables the programmer to 
check cards of a combined file that are not 
read into the work area by GET macro 
instructions to ensure that a specified 
card field (or fields) to be punched 
contains blanks. If the field is found not 
to contain all blanks, the PUT macro 
instruction is not executed. Instead, 
either control is transferred to a 
user-written routine (if the branch address 
is furnished by the PFXIT detail entry) or 
a system halt occurs. 

If a PUT macro instruction is given that 
refers to a combined file and the program 
proceeds to the PFORMTn error routine 
(user's exit), a subsequent GEr macro 
instruction will place the contents of the 
card that caused the PFORMT error into the 
work: area. If this GET macro instruction 
is in nonoverlap mode, it is possible to 
punch this card by means of an additional 
PUT macro instruction. 

The keyword of this entry is PFORMTn, 
where n is any number from to 9. The n 
position provides the programmer with the 
possibility of writing a maximum of ten 
different PFORMTn entries and thus having a 
maximum of ten fields checked. The 
specification for this entry is; 

xxyy 

where xx and yy are the numbers of t.ie 
first and last card columns, 
respectively f containing the field 
to be checked (for columns 1-9, the 
leading zero must be punched) . The 
input area must be large enough to 
permit IOCS to read tne information 
in these columns into storage. 

Figure ,28 shows an example of a PFORMTn 
entry specifying that a card field 



■ 
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comprising the columns 1-12 is to be 
checked for blanks prior to punching. 

r t t 1 

| Name | Operation | Operand | 

j. + f ^ 

I | | PFORMTl=0112, | 

L L J J 

Figure 28. PFORMTn Detail Entry 

The programmer may use a maximum of ten 
PFORWrn entries to perform checks on 
different card fields. But he may use only 
one PFXir entry for each file. 



The PFXIT Entry 

This entry is used in conjunction with the 
PFORMTn entry to specify the name of the 
user's routine to which control is to be 
transferred if the test made on the field 
specified by means of the PFORMTn detail 
entry indicates an error condition. 

Figure 29 shows an example of a PFXIT 
entry. 



If a PFORMTn check occurs, the IOCS 
branches immediately to the user's routine. 
In this case, the contents of the work area 
are not moved to the punch area. 

If this entry is omitted and the test 
shows an error condition, the machine halts 
before punching is initiated. This enables 
the operator to replace the card that led 
to the error condition. This card is 
positioned at the pre-punch station. 



DrFEN TERMINATING STATEMENT 

This terminating statement is usel to 
indicate the end of the entire set of 
definition statements for a given 
application. Only one terminating 
statement must be provided. It must 
immediately follow the last DTFSR 
statement. 

The terminating statement consists of 
the characters DTFEN in the operation 
field. Figure 30 shows an example of a 
DTFEN statement. 



%J 



r t t 1 

| Name | Operation | Operand | 

Y 1 + . -| 

| | |PFXIT=NAME, j 

L J J J 

Figure 29. PFXIT Detail Entry 



r t t i 

| Name | Operation | Operand | 

j. f_ x j 

| | DTFEN | j 

I X X J 

Figure 30. DTFEN Terminating Statement 
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DTFSR 



Operand 



Applies to 



Oper- 
ation 






Keyword 



DEVICE 



MFC Ml 
MFCM2 
CRP2D 
PUNCH20 



TYPEFLE 



Allowable 
Specifications 



x 

x 
+ 

X 

4 — 



PUNCH42 



READ01 



PRINTER 

PRINTLF 

PRINTUF 

INPUT | X 

OUTPUT | X 

h 



CMBND 



2560 



x. 

+— - 
f— - 



-+ 



X 

f— - 



X 



2520 
Read 
Punch 



x 

+ 

+— - 

+ 

f— - " 
x 



f 

+ 

i 

x 

+ — - 

K 



2520 
Punch 



T T 

1442 
Moiel 

5 
Punch 



x 

+ 

f— - 
+— 



f— - 
+— - 



— f 






x 

+ 

f— - 

+ 

+-— - 



f— - 
+— - 
f— - 
+-— 

X 



2501 



x 

+- 

+ 

+— - 
+- 



f— - 

+ 

f— - 

X 

-+ — 

-f— - 



2203 



x 

+ + 

4 f 

+- 

+ f 



X 

+- — 

X 

4- — 

X 

I- — 
+ — 

X 



1403 






x 



+ 

f +• 

+ + 

X 



Remarks 



., 



for 2203 with dual 
feed-carriage 



.j 



I 



Figure 31. Definition Statement Summary, Part 1 of 3 



V 



DEFINITION STATEMENT SUMMARY 



Figure 31 is a summary of the various 
entries available for the Model 20 IOCS 
definition statements. The chart sho//s the 
allowable entries that can be made in the 
various fields of the Basic Assembler 



coding form. In addition, it shows for 
which input/output unit(s) a specific entry 
may be required. For example, if a file is 
being read and/or punched by the 2 56 MFCM, 
the X's in the 2560 column indicate to the 
programmer which entries he may have to 
provide. 
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Operand 



Applies to 



Oper- 
ation 



j. 



Keyword 



PRINTOV 



+- 



tfORKA 



OVERLAP 



CONTROL 



EOFADDR 



f" 



IOAREA1 



+- 



IOAREA2 



BLKSIZE 



BINARY 



IN AREA 



■ + 



4 

INBLKSZ 



OUAREA 



■ + 



0UBLK3Z 



Allowable 
Specifications 



YES 



YES 



NO 



YES 



x 



name of user 

end-of-file 

routine 



name of the 

user-defined 

area 



name of the 

user-defined 

area 



length of sim- 
ple file in- 
put/output 
area in bytes 



YES 



INPUT 



name of 
combined file 
input area 



length of 
combined file 
input area in 
bytes 



name of 
combined file 
output area 



length of 
combined file 
output area 
in bytes 



2560 



x* 



-+■ 



x* 



2520 
Read 
Punch 



K* 



x* 



K 



2520 
Punch 



T T 

1442 
Model 

5 
Punch 



+ + 

x 



+ + 






2501 



4 + + 



2203 



x* 



1403 



-+- 



+ + 



4 4 



Remarks 



required if PRIOV 
is macro given for 
the file 



mandatory for all 
files 



if omitted, file 
processed in 
overlap mode 



required if CNTRL 
macro given for 
file 



♦mandatory for 
input and/or 
combined files 



♦entry required for 
22 03 only when 
dual- feed- carriage 
is used 



can be used if 
,25 01, Model A2 , is 
used in overlap 
mode 



specifies length of 
area specified by 
IOREA1 - IOAREA2 
entries 



♦mandatory for 
simple files 



only for combined 
files 



-+- 



combined files only 



combined files only 



combined files only 



combined files only 



.X JL. 



Figure 31. Definition Statement Summary, Part 2 of 3 
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Operand 



Applies to 



Oper- 
ation 



■+■ 



-+ 



Keyword 



CRDPRA 



CRDPRLn 



SEQNCE 



SEQXIT 



RFORMIn | xxyyz 



PFxir 



Allowable 
Specifications 



name of user- 
defined card 
print area 



length Of card 
print area in 
bytes 



xxyy 



name of user- 
routine 
used when 
SEQNCE test 
fails 



name of user- 
routine used 
when PFORMTn 
test fails 



2560 



RFXIT | name of user- | x | x | | I x 
routine used 
when RFORMTn 
test fails 

PFORMTn I xxyy | x | x 



2520 

Read 
Punch 



f 

x 



2520 
Punch 






1442 
Model 

5 
Punch 



I 
■H 



2501 






2203 



1403 



n in the keyword Is 
a print head nunber 

indicates sequence 
check of input 
cards desired from 
cols xx to yy 



Remarks 



must be specified 
when SE2NCE is 
specified 



indicates that a 
check for numerics 
or blanks is desir- 
ed from cols xx to 
yy in input carls 



indicates that a 
check for blanks is 
to be made of field 
from cols xx to yy 
prior to punching** 



■* 



■* 



** Applies to combined files only. 

Figure 31. Definition Statement Summary, Part 3 of 3 



THE IOCS MACRO IiSISTRUCTIONS 

This section describes the format, 
function, and use of the IOCS macro 
instructions that are used by the 
programmer to control input/output 
operations. These symbolic instructions 
are used in the main program to cause the 
Basic Assembler to insert the 
object-program linkages to the IOCS 
routines previously defined by means of the 
IOCS definition statement. 

I he macro instructions enable the user 
to design hio program free from most 



detailed considerations concerning input 
and output. 



The filling (i.e., reading into) and 
emptying (i.e., punching out and printing 
out) of the input and output areas will be 
handled automatically by the IOCS. All 
files will be handled in accordance with 
the information given the IOCS in tne 
definition statements. Source programs 
using the IOCS must not contain any Basic 
Assembler input/output instructions (i.e., 
XIO, TIOB, 210 and SPSW) . 



m ■' 



m ^ 
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Relative addressing of a work area is 
the only relative addressing permitted in 
the operand of a macro instruction. 



© 



Like trie ID 
macro instruct 
System/360 Ass 
IOCS macro ins 
according to t 
Basic Assemble 
that they may 
The mnemonic o 
written in the 
four operands 
field. Each m 
name, which is 
and may consis 



CS definition statements, the 
ions are written on the 
embler Short Coding Form. 
tructions must be written 
he rules specified for the 
r language with the exception 
have up to four operands, 
f t.he macro instruction is 

operation field and up to 
are written in the operand 
aero instruction may have a 

written in the name field 
t of up to four characters. 



The IOCS macro instructions are; 



SET 

PUT 

OPELM 

CLOSE 

PRTOv" 

CiMTRL 



(Check Printer Overflow) 
(Control) 

LOM (Leave Overlap Vlode) 
EOM (Enter Overlap Ylode) 
CRDPR (Card Print) 
//Aire (Wait Card) 

Note^ The Basic Assembler program does not 
perform a specific test of IOCS macro 
instructions. Therefore, a number of 
errors in macro instructions are not 
detected. 

The GET .viacrq Instruction 

The SET macro instruction makes the next 
record of the specified file available in 
the user-defined work area and, if 
necessary, transfers control to the 
appropriate- user's routine specified by the 
3EQXIT, RFXIi, or EOFADDR detail entries. 

Each SET macro instruction may have a 
name in the name field and must contain: 

1. GET in the operation field. 

2. A first operand, followed by a comma, 
specifying the file from tfhich the 
record is to be read. 



the read or punch area as a work area. For 
combined files working in the nonoverlap 
mode, the programmer may use only the punch 
area as a work area. 

Figure 32 shows a SET macro instruction 
that moves the next record from a file 
called FILE into a work area defined by the 
user's DS statement called WORK. 

r t t i 

| Name | Operation | Operand | 

^ + + ., 

| NAME | GET | FILE, WORK | 

L L J J 

Figure 32. SET Macro Instruction 

PROCESSING IN NONOVERLAP MODE. When a file 
is processed in the nonoverlap mode, a SET 
that refers to this file: 

1. Initiates a read operation for the next 
(or first) card of the file. (The data 
contained in the card is read into the 
input area) . 

2. Moves the data read from the input area 
into the work area after the read 
operation is complete. 

3. Iransfers control immediately to either 
a user's routine (SEQXIT, RFXIT, or 
EOFADDR) or to the main program. 

The read operation for the following 
card of this file is not initiated until 
another GET for the same file is executed. 

PROCESSING IN OVERLAP liODE. When a file is 
processed in overlap mode, the OPEN macro 
instruction for this file initiates a read 
operation. This causes the contents of the 
first card of the file to be read into the 
input area. Therefore, the first and any 
subsequent SET that refers to this file 
causes: 

1. The record that is contained in tie 
input area to be moved into the work 
area. 

2. A read operation to be initiated for 
the card following the card whose 
contents have just been moved into the 
work area. 






3. A second operand specifying the work 
area by a name or a relocatable 
expression. 

^2te^_ A work area need not £>e 
associated with any particular file. 
Each macro instruction specifies the 
work area to be used. Each work area 
used by a file must be at least as long 
as the input/output area for that file. 

For simple files working in tne 
non-overlap mode, the programmer may use 



3. Immediate transfer of control to either 
a user's routine (SEQXIT, RFXIT, or 
EOFADDR) or to the main program. 

An overlapping effect is achieved 
because a read operation for. the following 
card is initiated immediately after the 
desired record has been moved from the 
input area into the work area. Processing 
is performed while the following card is 
moved through the read station and the 
contents of this card are read into tie 
input area. 
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Card-Input Device 



Main Storage 



Execution of 



OPEN 



First 3Er 



Second GET 



OPE.vl 






First GET 



Second GET 



T T ++ T— ~ ~ "I 

Hopper/ | Read | Pre- Punch/ | | Contents of Input | Contents of Work | 
Pre-Read | Station | Stacker J | Area j Area | 

. X . X ; XX L i J 



Card 3 
Card 2 
Card 1 



NOrtDVERLAP MODE 
il 

II r 
III 

I I L. 



-1 I r 
III 

.J I L. 



1 I 

II 

- J l 



:ard 3 



"h 



II 
-ff- 



Card 2 



I I il I 

| | || f 1 | r „ __ 

| | Card 1 |||Data from 2ard 1 | | |Data from Card 
, > 1 I « J i L 

1. The contents of card 1 are read into the input area while, 
this card is moved through the read station. 

2. The contents of the input area (data from card 1) are moved 
into the work area after the read operation has been completed. 



11 



:ard 3 



1. 



| Card 2 
.> _ 

| Card 1 



-ff- 



| | r -, | r 1 

|||Data from ~ard 2 j | JData from Card 2| 

I I L . i I l j 



2. 



The contents of card 2 are read into the input area while 
this card is moved through the read station. 
The contents of the input area (data from card 2) are moved 
into the work area after the read operation has been completed. 



OVERLAP IViODE 



Card 4 
Card 3 
Card 2 



I! 



I 1 1 r — _ __ 1 | r ___ 

| Card 1 j j | Data from Card 1 | | | 

1. The contents of card 1 are read into the input area while 
this card is moved through the read station. 

Card 4 1 I SI | 



— t j 

II 
— j | 

I 

I 

— H 

I 



:ard 3 



| | Card 2 

| | Card 1 



I , r — . 1 , f .__ 

jj |Data from Card 2 (JjData from Card 
1 1 L __. J I l _ 



II 
II 



111 



1. The contents of the input area (data from card 1) are moved 
into the work area. 

2. The contents of card 2 are read into the input area while 
this card is moved through the read station. 



-XX- 






Card 4 



| Card 3 

•> — 

| Card 2 
| 

| Card 1 



JData from 2ard 3 j | |Data from Card 2 j j' 

L . . J I L ______J ! 



1. The contents of the input area (data from card 2) are moved 
into the work area. 

2. The contents of card 3 are read into the input area while 
this card is moved through the read station. 



Figure 33. Card Movement and Data Flow when a GET Macro Instruction is Executed 
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Figure 33 illustrates card movement and 
data flow from the card input device to 
main storage for the processing of a file 
in both the nonoverlap and the overlap 
modes. It also illustrates the position of 
a card in the card input device at the time 
the GET macro instruction for this card is 
executed. 

For an explanation of the relationship 
between the GET macro instruction and the 
CRDPR macro instruction, refer to the 
description of the CRDPR macro instruction. 



The PUT Macro Instruction 

The PUI macro instruction makes a record 
from the work area available for punching 
or printing and, if necessary, transfers 
control to the user's routine specified by 
the PFXIf detail entry. 

Each PUT macro instruction may have a name 
in the name field and must contain: 

1. PUT in the operation field. 

2. A first operand, followed by a comma, 
specifying the file to which the record 
is to be made available. 

3. A second operand specifying the work 
area by a name or a relocatable 
expression (when a simple file is 
processed in the nonoverlap mode, this 
can be the name of the punch area) . 



3. Immediately transfers control to the 
irain program. 



Whenever an output data record is 
transferred to an output device by a PUT 
macro instruction, the data remains in the 
work area until it is either cleared or 
replaced by other data. The IOCS does not 
clear the work area. Therefore, if the 
user plans to build another record having 
data that does not use every position of 
the work: area, he must clear this area 
before he builds the record. If this is 
not done, the new record and all of tie 
following records may contain interspersed 
characters from the preceding record. 

Figure 34 shows a PUT macro instruction 
that makes a record available to a file 
called DETL from a work area whose 
beginning address is MSTR+150. 

r t t 1 

j Name | Operation | Operand | 

j. f 4. ., 

| NAME | PUT |DETL,MSTR+15 | 

I J. X J 

Figure 34. PUT Macro Instruction 

For an explanation of the relationship 
between the PUT macro instruction and the 
CRDPR macro instruction, refer to the 
description of the CRDPR macro instruction. 



%0 



Note_: A work area need not be 
associated with any particular file. 
Each macro specifies the work area. 
Each work area used by a file must be 
at least as long as the input/output 
area for that file. 

When processing is being performed in the 
nonoverlap mode (card punching only) , tne 
PUT macro instruction: 

1. Moves a record from the work area to 
the output area. 

2. Initiates the punch operation (and the 
next read operation in the case of a 
combined file). 

3. Transfers control to the main program 
when the punch operation is complete. 

When processing is being performed in the 
overlap mode, the PUT macro instruction: 

1. Moves a record from the work area to 
the output area. 

2. Initiates the punch or print operation 
(and the next read operation in the 
case of a combined file) . 



PROGRAMMING CONSIDERATIONS — COMBINED 
FILES. If a combined file is being 
processed by the following sequence of 
instructions: 

GET F1,W1 

no GET, EOM, or 

PUT macro 

instruction referring 

to file Fl 

PUT F1,W2 

the following rules apply: 



^OQOV^SL^E • rne pur F l macro instruction 
causes punching into the card made 
available by the GET Fl macro instruction. 



Overlap. The PUT Fl Macro instruction 
causes punching into the card that follows 
the one made available by the GET Fl macro 
instruction, because the card made 
available by the GET Fl macro instruction 
is already past the punch station when the 
PUT Fl macro instruction is given. 
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I he OPEN ytacro Instruction 

This macro instruction ensures that all the 
information required to handle a file has 
been provided. 



For an input fi 
overlap mode, the 
causes the first c 
contents is then a 
the input area int 
first GET for the 
an input file to b 
non- overlap mode, 
macro instruction 
the file: 



le to be processed in 
OPEN macro instruction 
ard to be read. Its 
vail able to be moved from 
o the work area when the 
file is encountered. For 

processed in 
the function of che OPEN 
depends on the type of 



1. .'or a simple file, the OPEN macro 
instruction makes the file available 
for processing. 

2. For a combined file, the OPEN macro 
instruction causes the first card to be 
read while this card is moved to the 
pre-punch station. 

The OPEN macro instruction must be 
issued before any other macro instruction 
regarding the same file is given. Ths 
programmer must write a separate OPEN macro 
instruction for each file. 

Each OPEN macro instruction may have a 
name in the name field and must contain: 

1. OPEN in the operation field, and 

2. one and only one operand indicating the 
file "to which this OPEN macro 
instruction applies. 

Figure 35 shows an OPEN macro 
instruction labeled NAME for a file called 
PAY. 

r t -t 1 

| Name (Operation (Operand | 

j. + f ., 

J NAME | OPEN | PAY | 

I J. X. J 

Figure 35. OPEN Macro Instruction 

The CLOSE, Macro_ Instruction 

This macro instruction ensures proper 
handling of the file after all records have 
been processed. 

Specifically, the CLOSE macro 
instruction ensures: 

1. rhat records remaining in the output 
area upon completion of processing are 
printed and/or punched out. 

2. That all processed data cards remaining 
in the card feed path (not end-of-file 



cards) are selected into the 
appropriate stackers . 

A CLOSE macro instruction must be given 
for each file after the processing of all 
records of the file has been completed. 
For input files, the CLOSE macro 
instruction is normally given in the user's 
end-of-file routine. A file may not be 
reopened by an OPEN macro instruction after 
it has been closed. 

Each CLOSE macro instruction may have a 
name in the name field and must contain: 

1. CLOSE in the operation field. 

2. One and only one operand indicating the 
file to which this CLOSE macro 
instruction applies. 

Figure 36 shDws a CLOSE macro 
instruction for a file called DETL. 

r t t 1 

(Name (Operation | Operand | 

j. + + ., 

( NAME | CLOSE | DETL | 

L X J J 

Figure 36. CLOSE Macro Instruction 

The PRTOV Macro Instruct ion 

The PRTOV macro instruction can ba used by 
the programmer to check for 
printer-overflow conditions. 

The PRTOV macro instruction consists of 
PRTOV in the operation field, followed by 
two or three operands of the form 

SYMB,m 



or 



S if MB, m, ROUT 

where SYME is the symbolic name of the 
printer file, 

m is 9 or 12 to specify wiich 
carriage-tape channel 
indicator is to be cheated, 

and 

ROUT is the symbolic name of the 
user routine to be executed 
when an overflew occurs. 

The PRTOV macro instruction allows the 
programmer tD check for printer-overflow 
conditions by testing whether a channel 9 
or channel 12 indicator has been set on: 

1. Before execution of the last (preced- 
ing) PUT macro instruction referring to 
a printer with the standard carriage. 






I 
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2 . Before the execution of the last Pur 
macro instruction referring to a 
printer with the dual feed carriage 
when only the lower feed is used. 

3. Before the execution of the 
next-to-last PUT macro instruction 
referring to a printer with the dual 
feed carriage when both feeds are used. 

However, if a skip has been performed or 
more than one line has been spaced after 
the last PUT macro instruction (or after 
the next-to-last PUT macro instruction if 
the associated DTFSR statements contain 
PRINTUF and PRINTLF) any punch that may be 
sensed in channel 9 or channel 12 is lost 
and cannot be determined by a PRTOV macro 
instruction. 



for the CNTRL macro instruction: one for 
printer spacing, one for printer skipping, 
and two for card stacking. Each of the 
four types is described separately in the 
following sections. 



CN1RL Macro Inst ru ction for Printer Spacing 

This macro instruction can be used to 
specify immediate spacing and/or delayed 
spacing (space after print) of the printer 
carriage. 



The CNTRL macro instruction for spacing 
consists of CNTRL in the operation field 
followed by an operand of the form: 






The program branches to the end-of-page 
routine if the tested indicator is on and 
the name of the routine has been specified 
as the third operand. In the end-of-page 
routine, any IOCS macro instruction (except 
PRIOV) may be, issued, e.g. to print page 
totals and, upon a skip to channel 1, 
heading lines on the new page. At the end 
of the routine, control must be returned to 
the IOCS by branching to the address 
contained in register 14. 

If IOCS macro instructions are used in 
the end-of-page routine, the contents of 
register 14 must be saved before these 
instructions are executed. 

If a third operand has not been 
specified in the PRTOV macro instruction, 
an automatic skip to channel 1 is performed 
when the tested indicator is on. 



SiTMB,SP,m,n 



where SYMB is the name of the printer 
file 



SP specifies spacing 

m is the number of lines the 
form is to be spaced 
immediately (m = 0, I, 2, or 
3) , and 

n is the number of lines the 
form is to be spaced after 
printing (n = 0, 1, 2, or 3). 

The programmer may omit either m or n . 
A name may be assigned to each CNTRL macro 
instruction. 



mj 



The DTFSR file definition statement must 
have a PRINTOV=YES entry when a PRTOV macro 
instruction is issued for the file. 

Figure '37 shows a PRTOV macro 
instruction referring to a file named PRdT 
and specifying tnat the program branches to 
the user routine named OVFL when a 
channel- 9 punch is sensed in the carriage 
tape. 

r • — t t 1 

| Name | Operation | Operand | 

V + j. 1 

| NAME j PRTOV |PRNT,9,OVFL j 

L J . J r , J 

Figure 37. PRTOV Macro Instruction 

The CNTRL Macro Instruction 

The CNTRL macro instruction can be used by 
the programmer to cause printer spacing, 
printer skipping, and card stacking to be 
performed in other than the normal manner. 
There are four different formats available 



If a CNTRL macro instruction specifying 
delayed spacing is not given before tie 
next PUT for the printer file, the printer 
carriage advances one space after the print 
operation is completed. When two CNTRL 
macro instructions specifying delayed 
spacing are given before the next POT for 
the printer file, the spacing specified in 
the second CNTRL macro instruction is 
effective (i.e., the second CNTRL macro 
instruction overrides the first). If 
delayed spacing and skipping are both 
specified before a PUT for the printer 
file, only the last specified operation 
will be performed. 

Because of timing considerations, 
delayed spacing should be used whenever 
possible in order to increase system 
throughput. 

Figure 38 shows a CNTRL macro 
instruction referring to a printer file 
named LIST and specifying that the form is 
to be spaced three lines immediately and 
one line after printing. 
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r t t 1 

| Name | Operation | Operand | 

I. + + ^ 

| NAME | CNIRL | LIST, SP, 3,1 | 

L JL X . . —J 

Figure 38. CNTRL Macro Instruction for 

Printer Spacing (Immediate and 

Delayed) 

Figure 39 shows a CNTRL macro 
instruction referring to a printer file 
named LIST and specifying that the form is 
to be spaced one line immediately. 

r * t ■ t ■ 1 

| Name | Operation | Operand | 

f _ + x ^ 

I NAME | CNTRL |LIST,SP,1 | 

L J J J 

Figure 39. CNIRL Macro, Instruction for. 
Printer Spacing (Immediata) 

Similarly, Figure 40 shows a CN'IRL macro 
instruction specifying that 2 lines are to 
be spaced after printing only. Note that 
the omission of tha operand m is indicated 
by a comma . 

r t t 1 

| flame (Operation | Operand | 

> x x -I 

I NAME | CNIRL |LIST,SP,,2 | 

L X i J 

Figure 40. CNIRL Macro Instruction for 
Printer Spacing (Delayed) 

C NTRL Macro Instruction fpr_ Printer 
Skipping 

Ihis macro instruction can be used to 
specify the channel of the carriage control 
tape to which the carriage tape is to be 
skipped immediately and/or after the 
printing of a line. 

Tha CNTRL macro instruction for printer 
skipping consists of CNIRL in the operation 
field followed by an operand of the form: 



where SYXIB 



SK 



SYMB,SK,m,n 

is the name of the printer 
file, 

specifies skipping, 

is the number of the tape 
channel to which the carriage 
is to be skipped immediately 
(m = 1, 2, . . .,12), and 

is the number of the tape 
channel to which tne carriage 
is to be skipped after 
printing (n = 1, 2,.. .,12). 



The programmer may omit either m or n. 
A name may be assigned to each CNTRL macro 
instruction. 

tfhen two CNTRL macro instructions 
specifying delayed skipping are given 
before the next PUT for the printer file, 
the skipping specified in the second CNIRL 
macro instruction is effective (i.e., tne 
second CNTRL macro instruction overrides 
the first) . 

Because of timing considerations, 
delayed skipping should be used whenever 
possible in order to increase throughput. 

Figure 41 shows a CNTRL macro 
instruction referring to a printer file 
called REPT and specifying that control is 
to be transferred immediately to channel 11 
of the printer tape and to channel 12 after 
printing. 

r t t ' 1 

| Name (Operation (Operand | 

j. x x _ < 

| NAME | CNTRL | REPT, SK, 11, 12 ( 

L X X . J 

Figure 41. CNIRL Macro Instruction for 

Printer Skipping (Immediate and 
Delayed) 

Figure 42 shows an example of a CNTRL 
macro instruction referring to a file named 
UPDr and specifying that carriage control 
is to be transferred to channel 4 
immediately. 

r t t 1 

| Name (Operation | Operand | 

j. x x _ 1 

| NAME (CNTRL |UPDT,SK,4 | 

I X „J J 

Figure 42. CNIRL Macro Instruction for 
Printer Skipping (Immediate) 

Figure 43 shows a CNTRL macro 
instruction referring to a file called NEW 
and specifying that carriage control is to 
be transferred to channel 7 after printing. 
Note that the omission of the operand m is 
indicated by a comma . 

r t t — 1 

( Name (Operation (Operand | 

j. x x ^ 

| NAME | CNTRL |NEW,SK, # 7 ( 

I -_X X J 

Figure 43. CNIRL Macro Instruction for 
Printer Skipping (Delayed) 

CN f lRL__Macro Instruction f or__Stacking 

This macro instruction applies only to 
multistacker devices. It specifies the 
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stacker into which cards of the file are to 
be selected. 
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contents are transferred to or from the 
work area by the GET (or PUT) macro 
instruction. 



Two formats of this macro instruction 

are available: one specifies the name of 

the file whose cards are to be stacked; the 

other does not specify a file name. These CN1RL AAAA,SS,n 

two formats are described as Format I and no GET or PUT macro 

Format II, respectively. instruction referring 

to file AAAA 

F ORMA T I. This format of the CNTRL macro GET (or PUT) AAAA.,xxxx 

instruction specifies the file whose cards 

are to be stacked. 

This macro instruction consists of CNrRL NONOVERLA P M ODE. The CNTRL macro 

in the operation field followed by an instruction nust be issued after tha GET 

operand of the form: macro instruction or before the PUT macro 

instruction that moves the card to be 

SYMB,SS,n selected. 



where 



SYMB is the name of the file whose 
cards are to be stacked 



SS identifies this as a stack 
macro instruction, and 

n is the number of the stacker 
into which the cards are to 
be selected. 

I When two Format- I CNTRL macro 
instructions for stacking pertaining to the 
same file are given before a GET or PUT 
macro instruction for that file, the 
stacker selection specified in the second 
CNTRL macro instruction is effective (i.e., 
the second CNTRL macro instruction 
overrides the first) . 

Figure 44 shows a CNTRL macro 
instruction specifying that a card of a 
file named DAY is to be stacked in stacker 
2 of the device handling this file . 

r t t T 

I Name | Operation | Operand | 

j. + x -I 

| NAME | CNTRL | DAY , SS , 2 j 

L X X J 

Figure 44. CNTRL Macro Instruction for 
Stacking 

The following explains the relationship 
| between a given Format-I CNTRL macro 
instruction and the GET, PUT, or ECM macro 
instruction referring to the card to be 
selected. 



OVERLAP_MODE^ If the file is being 
processed in the overlap mode, the Format-I 
CNTRL macro instruction must be the last 
macro instruction preceding the GET or PUT 
that refers to the card to be selected. 

In the example below, the CNTRL macro 
instruction shown selects the card whose 



In the coding sequence below, tha CNTRL 
macro instruction shown selects the card 
read by the GET macro instruction. 



GET AAAA,xxxx 



CNTRL AAAA,SS,n 



no PUT, GET, or EOM 
macro instruction re- 
ferring to file hh.Ah 



In the coding sequence below, the CNTRL 
macro instruction shown selects the card 
moved by the PUT macro instruction. 

CNTRL AAAA,SS,n 

no PUT, GET, or EOM 

macro instruction re- 

f erring to file hhAh 

PUT AAAA,xxxx 

Format II 

This format of the CNTRL macro instruction 
can be used only for the stacking of cards 
from files read and/or punched by the 2560 
|MFCM. Format II of the CNTRL macro 
instruction specifies the desired stacker 
but not the file whose cards are to be 
selected. 

This format of the CNTRL macro 
instruction consists of CNTRL in the 
operation field followed by an operand of 
the form: 

,SS,n 

where SS indicates that the CNIRL macro 
instruction is to be used for 
stacking, and 
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n is the number of the stacker 

into which the cards are to be 
selected. 

A name may be assigned to each CNTRL 
macro instruction of this format. 

When two Format-II CNTRL macro 
instructions for stacking are given before 
the stacker selection is performed, the 
stacker selection specified in the second 
CNTRL macro instruction is effective (i.e., 
the second CNTRL macro instruction 
overrides the first) . 

Figure 45 shows a CNTRL macro 
instruction specifying that cards are to be 
stacked into stacker 3 of the 2560 MFCM. 

r-' 1 t t 

| Name (Operation | Operand | 

l- + x ., 

| NAME | CNTRL |,SS,3 j 

L X J J 



If an LOM macro instruction is given for 
a particular file, all subsequent GET macro 
instructions for that file are performed in 
nonoverlap mode until an EOM (Enter- 
Overlap-Mode) macro instruction is given.. 
(Refer to the section The EOM Macro 
Instruction for further information 
concerning the use of the LOM with EOM.) 

The EOM Macro Instruction 

The EOM (Enter-Overlap-Mode) macro 
instruction applies only to combined Eiles 
for which a previous LOM macro instruction 
has been given. This macro instruction (1) 
causes the next card to be read into the 
read area, and (2) causes subsequent GET 
macro instructions addressing the same file 
to be performed in the overlap mode. The 
processing of the file in overlap mode 
begins immediately after the EOM is given. 

Each EOM macro instruction may have a 
name and must contain: 



Figure H5. CNTRL Macro Instruction for 
Stacking (2560 MFCM) 

The relationship between the Format -II 
CNTRL macro instruction and the GET, PUT, 
or EOM macro instruction referring to the 
card to be stacked is the same as that 
described for the CRDPR macro instruction, 



The LOM Macro Instruction 

The LOM (Leave Overlap Mode) macro 
instruction applies to combined files 
specified to be processed in the overlap 
mode. The processing of the file begins in 
nonoverlap mode after the next GET macro 
instruction for the specified file is 
executed. 

This makes it possible to read and punch 
into the same card of a combined file that 
is being processed in the overlap mode. 

Eacn LOM macro instruction may have a 
name and must contain: 

1. LOM in the operation field. 

2. An. operand specifying the name of the 
file to which the macro instruction 
applies. 

Figure 4 6 shows an example of an LOM 
macro instruction. 

r 1 T n 

| Name (Operation | Operand | 

I. ___x x _ ., 

( NAME | LOM | TRAN | 

L JL . X J 

Figure 46. LOM Macro Instruction 



1. EOM in the operation field, and 

2. an operand specifying the name of the 
file to which the macro instruction 
applies. 

Figure 47 shows an example of an EOM 
macro instruction. 

r t t 1 

| Name (Operation | Operand | 

j. — x + j 

| NAME | EOM | UPDT | 

L X X _J 

Figure 47. EOM Macro Instruction 

Programming Considerations - LOM and EOM 
Macro_ In struct ions 

A card that belongs to a combined file can 
be read and then punched only if the card 
is read by a GET macro instruction in 
non-overlap mode. There are three possible 
ways to cause the GET to operate in 
non- overlap mode during this operation 
(reading and punching of the same card): 

1. Provide an OVERLAP=NO detail entry for 
the file. In this case, the IOCS 
generates GET and PUT/ routines for this 
file that operate in nonoverlap mode. 

2. Do not provide an OVERLAP=NO detail 
entry for the file. Then in the source 
program give an LOM macro instruction 
between the OPEN and the first GET 
macro instruction for the file. In 
this case, GET and PUT routinss taat 
operate in the overlap mode are 
generated for the file. However, all 
GET macro instructions for the file 
operate in nonoverlap mode. 
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3. Do not provide an OVERLAP=NO detail E 

entry for the file. Ihen, in tha does 

source program, precede each G^I .nacro the 

instruction with an LOM macro whic 

instruction and follow each GET with a into 

test to determine if a punching exec 

operation is to be performed on this macr 

card. If not, operation of this file spec 

can be changed back to the overlap mode are 
by an EO>i macro instruction. 



o 



© 



The first method results in a decrease 
of program speed. 

The second method is the most 
satisfactory solution when nearly every 
card of a file must be both read and 
puncned. The program speed does not 
decrease as much as with the first method 
because the PUT routines will operate in 
the overlap mode. 

The third method is usually the most 
satisfactory solution when only a few 
specified cards in a combined file must be 
noth read and punched. tfhen this method is 
used, each card is read in the nonoverlap 
mode and thus can be subsequently punched. 
However, when punching is not to be 
performed, the program immediately begins 
operation in the overlap mode. ihis third 
method requires some additional main 
storage positions for the extra LOK and EOM 
macro instructions, but it results in a 
program that runs at nearly the same speed 
as a program operating entirely in the 
overlap mode. This programming method is 
illustrated in tne sample program coding 
shown in Figure 63 (Appendix D) . 



Tfr. e .^iB:DPft_M a 9go. instruction 

This macro instruction can be used only if 
the user has a 2560 Multi-Function Card 
Machine equipped with the Card Print 
Feature. 

The CRDPR macro instruction moves 
information to be printed on a card from 
the work area to the card print area 
specified as the third operand of this 
macro instruction. For each line to be 
printed, the programmer must write one 
CRDPR macro instruction. If two CRDPR 
macro instructions are given for the same 
line, only the last one will be executed. 

Because the CRDPR macro instruction does 
not refer to a specific file, it does not 
have a file-name operand. The absence of 
this operand is indicated by a comma 
(Figure 48). The second operand is the 
name of the work area, and the third 
operand is the name of the card print area. 
A name may be assigned to a CRDPR macro 
instruction. 



xecution of a CRDPR macro instruction 

not immediately result in printing on 
card. Printing occurs when the card on 
h printing will take place is moved 

and through the print station by the 
ution of a following GET, PUT, or EOM 
o instruction. At that time, all 
ified print lines for a particular card 
printed simultaneously. 



All lines are pri 
print operation is p 
possible to print on 
during one print ope 
with print heads 1 a 
print operation. Th 
not to print any dat 
heads ay simply not 
its respective print 
was performed in the 
area before printing 



nted each t 
erformed. 
ly with pri 
ration and 
nd 2 during 
erefore it 
a with one 
entering an 
area or, i 
area, by c 
takes plac 



lme a card 
It is not 
nt head 1 
thsn print 

another 
is possible 
of the print 
y data into 
f processing 
learing the 
e. 



Figure 48 shows an example of a CRDPR 
macro instruction. This macro instruction 
moves, a line of information from the work 
area named WORK into the print area named 
TOIL. 

r t t 1 

| Name | Operation | Operand | 

^ + + .| 

| NAME | CRDPR |,WORK,TOTI | 

L i. J J 

Figure 4 8. CRDPR Macro Instruction 

As stated previously, the CRDPR macro 
instruction does not address a particular 
file. Therefore the card on which printing 
will take place must be moved into and 
through the print station by a GET, PUT, or 
EOM macro instruction. The programmer can 
determine, from the following three 
explanations, the sequence of GET, PUT, or 
EOM instructions required for his 
application. 

1 • Processing_in the_Oyerlap yiode 

If the card on which printing will take 
place is punched by a PUT macro 
instruction, the CRDPR macro instruction 
must be given before any subsequent PUT, 
GET, or EOM macro instructions addressing 
an MFCM file. 3ee the following coding 
sequence. 



PUT (or GET) Fl,xxxx 



CRDPR ,xxxx,cardprint 



no PUTs, GErs or 
EOMs referring to 
MFCM files. 
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2 • P£2£§§§iS3L_iS_the_Nonoverlap_Mode_- 
Format_A 

If the card on which printing will take 
place is punched by a PUT macro 
instruction, then the CRDPR macro 
instruction must be given prior to any 
other GEI, PUT, or EOM macro instruction 
that addresses an MFCM file. See the 
following coding sequence. 



PUT Fl ,xxxx 



CRDPR ,xxxx,cardprint 



no PUTS, GETS, or 
EOM3 referring to 
MFCM files. 



There is one exception to the above 
case. 



A GET Fl macro instruction may be 
inserted between the PUT Fl and the CRDPR 
macro instructions. See the following 
coding sequence. 

PUT Fl,xxxx 

no PUTS, GETS, or 

EOMs referring to 

MFCM files. 

GET FL ,xxxx 

no PUTS, GETS, or 

EOMs referring to 

: MFCM files. 

CRDPR , xxxx, cardprint 

3 • Processing in the ijqnoverlap Mode - 
Format B. 



If the card on which printing will take 
place is read by a GET macro instruction 
referring to a file named Fl, then another 
GEI Fl , EOM Fl , or PUT Fl macro instruction 
must be given before the CRDPR macro 
instruction. See the following coding 
sequence. 



GET F1,XXXX 

any combination of 

macro instructions 

referring to File 2. 

GET (or PUT or EOM) 
Fl,xxxx 

no PUTs, GETS, and 

EOMs referring to 

MFCM files. 

CRDPR , xxxx, cardprint 

CAUriOJNh When a CRDPR macro instruction is 
executed, the data that is contained In the 
specified work area is moved into the 
specified card print area. If the contents 
of the card that is made available by the 
first GET (refer to the above example) is 
to be printed on the same card, the work 
area specified in the second GET macro 
instruction must not be the same as tie one 
specified in the first GET macro 
instruction* Specifying the same work area 
in both GET macro instructions causes the 
contents of the card that is read by the 
second GET to be card-printed on the card 
that is read by the first GET. 



WAITC Macro Instruction 



The WAITC macro 
problem program 
of all pending i 
before the next 
executed. This 
the programmer t 
operating condit 
printer input/ou 
in the program. 



instruction causes the 
to wait for the completion 
nput/output operations 
sequential instruction is 
macro instruction enables 
o establish uniform 
ions for all card and 
tput devices that are used 



Figure 49 shows an example of a WAITC 
macro instruction. WAITC macro 
instructions may or may not have a name. 
Since this macro instruction neither refers 
to a particular file nor requests a 
particular control function, an operand is 
not required. 

r t — t 1 

| Name (Operation | Operand | 

j. + + _ _l 

| [NAME] | WAITC j | 

L i . J J 

Figure 4 9. Example of a WAITC Macro 
Instruction 



o 



c 



In a program using the IOCS, a WAITC 
macro instruction must be issued if one of 
the following conditions exist: 



o 
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1. A programmed stop is required to permit 
an error card to be replaced in a file 
whose cards are to be read in overlap 
mode. 

2. A programmed stop is required to permit 
an error card to be replaced in a file 
whose cards are to be read on the IB>. 
2560 in nonoverlap mode and a file in 
the other feed of the IBM 2560 is to be 
processed in overlap mode. 

Except for the condition 2, above, a 
WAITC macro instruction need not be issued 
to permit the replacement of an error card 
if the cards of the file are to be read in 
nonoverlap mode. 

Programming with t he _ WAITC Macro 
Instruction 

A GET macro instruction that refers to a 
card file may or may not immediately 
initiate a read operation. Ihis depends on 
the operating condition of the input/output 
device involved. If the initiation of the 
input/output operation is delayed, tha IOCS 
places the device request into a waiting 
list. The IOSS handles the device requests 
in this waiting list and executes the 
appropriate input/output operations as the 
requested input/output devices become 
available. 



When a GET macro 
the IOCS makes the 
available to the pr 
specified work area 
program determines 
contains an error, 
to provide a stop ( 
enable the operator 
correct the error c 
the hopper, and (3) 
operation. 



instruction is issued, 
desired card record 
oblem program in the 

If the problem 
that this record 
the programmer may want 
HPR instruction) to 

to (1) remove and 
ard, (2) return it to 

resume normal system 



© 



The programmer has no means to determine 
the status of the waiting list at the time 
the error is detected. Moreover, he is not 
able to determine the exact position of the 
error card in the input/output device. 
Therefore, the standard restart procedures 
cannot be applied. 

Before he issues the HPR instruction, 
the programmer must issue a WAITC macro 
instruction to (1) establish uniform 
operating conditions for all card (and 
printer) input/output devices and (2) 
determine the exact position of the error 
card. 

After the execution of the WAITC macro 
instruction, the waiting list contains no 
pending input/output device requests, 
except those for card printing. The error 
card (to be fed as the first card on 
restart) is determined by the number of 



cards that have to be returned to the input 
deck after the nonprocess runout. The 
number of cards to be returned to the input 
deck depends on the input/output device 
used and, in case of an MFCM file, on the 
mode of operation. For details, refer to 
Figure 50, which is a summary of the lalt 
and restart information. 



DUMMY GET MACRO INSTRUCTIONS: To ensure 
proper program functions on restart, i.e., 
resume processing with the record from the 
corrected card, the programmer must issue 
either one or two dummy GET macro 
instructions as shown in Figure 50. 



For the explanation below, processing in 
the overlap mode is assumed, unless it is 
stated that the information applies to 
files that are processed in nonoverlap 

mode . 



After the execution of a WAITC macro 
instruction, the contents of the card 
following the error card is already in the 
input/output area. Therefore, the first 
GEI macro instruction that is encountered 
after restart moves the record from the 
card following the error card into the work 
area. To make sure that the contents of 
the corrected error card has been moved 
into the work area before normal processing 
is resumed, the first SET macro instruction 
encountered after restart must be a dummy 
GET, i.e., no processing must be performed 
on the record moved into the work area by 
means of this SET macro instruction. If an 
IBM 25 01 is used to read the cards of a 
file and two input/output areas have been 
defined for this file, two dummy SET macro 
instructions are required. 

If an IBM 2560 MFCM is used to process 
two input and/ or combined files in one 
program, an error card in one file requires 
one dummy GET macro instruction on restart 
for each of the files with one exception: 
Only one dummy SET macro instruction is 
required for the file that contains tne 
error card if (1) the cards of the other 
(nonerror) file are read in nonoverlap mode 
and (2) no SET has yet been given for the 
file. The programmer must provide a switch 
to determine whether or not a GET has 
already been executed for the non- error 
file. This is illustrated in the coding 
example shown in Figure 5.1. 

A GET macro instruction for a file that 
is to be processed in overlap mode may be 
preceded by a CNTRL macro instruction 
referring to the same file. If this GET 
macro instruction detects an error card, 
the programmer must do either of the 
following in his restart routine: 
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1. Repeat the CNTRL macro instruction 
after the dummy SET macro instruction 
for the file in his restart routine. 

2. Branch to the CNTRL macro instruction 
preceding the SET macro instruction 
that detected the error card. 

Similar rules apply if two files are 
processed on the IBM 2560 MFCM in one 
program. Any file-dependent CNTRL macro 
instruction that precedes the last GET 
macro instruction in either file must be 
repeated after the dummy GET macro 
instruction for the file and before 
resuming normal processing. A preceding 



file -independent CNTRL macro instruction 
(no file name specified) need be repeated 
only once. 



Figure 50 is provided to facilitate the 
programming of restart routines and to 
furnish card-handling information that is 
not convered in the Model 20 IOCS Operating 
Procedures. The programmer must inform the 
operator of the number of cards to be 
returned to and placed in front of the 
remaining cards of the input deck. Any 
runout cards that are not to be returned to 
the input deck must be placed into the 
proper stacker manually. 



O 



| WAITC | Number of 
(required | Dummy GETs 



T 1 

Number of Cards to be 
returned 



I/O 
Device 



Mode of Operation 



| Non- error 
Error Feed | Feed 



2501 



Nonoverlap 



| do 



Overlap with one I/O area 



(Yes 



Overlap tfith two I/O areas 



Yes 



2560 
Feed 1 



Nonoverlap 



NO* 



Overlap 



Yes** 



€ 



2560 

Feed 2 



Nonoverlap 



|No : 



Overlap 



Yes** 



2520 



Nonoverlap 



i>iO 



Overlap 



Yes 



•+• 



-f- 



+ 1 

♦WAITC macro instruction is required if a file in the other feed is processed in 
overlap mode. 
♦♦Only required for the file containing the error card. A dummy GET is required for 
both files. 



Figure 50. Programming with the WAITC Macro Instruction — rialt and Restart Information 



An IOCS provided halt (due to a machine 
check) may occur during or immediately 
after the user-programmed restart routine 
and the number of cards in the input/output 
device may be less than stated in the 
appropriate standard procedure as described 
in the SRL publication IBM System/360 Model 
2 Qi._Car3 Programming Support _Input/Output 
Control System Operating Proc edures , Order 
No. GC26-3803. In this case, only those 
cards must be stacked manually which aere 
in the card feed of the input/output device 
at the time the halt occurred and which do 
not have to be returned into the respective 
hopper. 



The coding example in Figure 51 
illustrates programming with the WAITC 
macro instruction. The example includes a 
simplified restart routine. For the 
purpose of this coding example, the 
following is assumed: 

1. Two files (AAA and BBB) have been 
defined to be read in the two feeds of 
the IBM 2560 MFCM, 

2. File AAA is to be processed in the 
overlap mode and tne cards of this file 
are to be fed from hopper 1 of 256 
MFCM. This file may be an input or a 
combined file. 

3. File BEB is an input file whose cards 
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are to be read in noaoverlap mole. 
4. Any card of file AAA that does not have 
a 1-punch in column 1 is an error card 
and must be replaced. 



Only tuose instructions that illustrate 
programming with the WAITC macro 
instruction are shown in E igure 51. These 
instructions are identified oy sequence 
numbers in parentheses in the rightmost 
column of Figure 51. The sequence numbers 
are used as a reference in the explanations 
below. 



o 



If a card o 
1-punch in col 
is not perform 
the WAITC macr 
precedes an HP 
restart, the p 
two dummy GEI 
lummy GET macr 
(10) is execut 
instruction ha 
BBB. In tnis 
named SW (11) 
dummy GEI macr 
bypassed. Con 
problem progra 
repeat the CNI 
preceding the 
caused the err 



f file AAA does not contain a 

umn 1, the branch to NERR (7) 

ed and the program executes 

o instruction (8) that 

R instruction (9). On 

rogram executes either one or 

macro instructions. Only one 

o instruction for file AAA 

ed if no GET macro 

s yet been executed for file 

case, the branch instruction 

is executed and the second 

o instruction (12) is 

trol is returned to the 

m by a branch to REPT to 

RL macro instruction 

GEi macro instruction that 

or card to be detected. 



If a GET macro inst 
been executed for the 
the error carl is dete 
instruction named SW ( 
because it has been ch 
no- operation ( BC 0) in 
the MI instruction (2 
macro instruction (1) 
The CNTRL macro instru 
(3) is only effective 
detected. If an error 
four cards would have 
file AAA and two cards 



ruction has already 
file BBB at the time 
cted, the branch 
11) is not executed 
anged to a 

struction by means of 
) following the GEI 
for the file BBB. 
ction for file BBB 
when no error card is 

card was detected, 
to be returned for 

for file BBB 



If the cards of the file BBB were to be 
read in overlap mode, instructions (2) and 
( 11) would have to be omitted. 



r~ 


t - -t - r~ - l 




|Opera- 




Instr | 


| Name 

L 


| tion 
j. _j 


Operand 

L J 


Sqnce j 

L J 


r 


T T T 1 




[GET 


BBB,WRK2 


(1) | 




|MVI 


SW+1,X' 00" 


(2) | 




| CNTRL 


BBB,SS, 4 


(3) | 


|REPT 


|CNrRL 


AAA,SS, 2 


(4) | 




|GEP 


AAA,WRK1 


(5) | 




|CLI 


WRK1,C 1' 


(6) | 




| EC 


8, NERR 


(7) | 




|WAITC 




(8) | 




|HPR 


X'FFF" , 


(9) | 




|GET 


AAA,WRK1 


(10) | 


| SW 


| EC 


15, BPSS 


(11) | 




|GET 


BBB,WRK1 


(12) | 




|CNrRL 


BEB,S3, 4 


(13) | 


| BPSS 


|BC 


15, RE PI 


(14) | 


|NERR 


j; 







L X X X J 

Figure 51. Coding Example -- Programming 
with the WAITC Macro 
Instruction 



If the cards of a combined file are also 
to be card-printed and this file is to be 
processed in nonoverlap mode, the following 
must be considered by the programmer. 



Unless successive cards are to be read 
which are not to be punched, a GET macro 
instruction for a card does not initiate 
card movement. Card movement is initiated 
by the PUT macro instruction for the 
preceding card. Therefore, the programmer 
must issue a dummy GET macro instruction 
prior to the WAITC macro instruction to 
ensure that the desired card- print 
operation for the card preceding the error 
card is properly executed. This is further 
explained in the coding example shown in 
Figure 52. 



4% 



The coding example in Figure 52 is based 
on the assumption that: 

1. The first card of the file CMBF has 
already been read. 

2. Data is to be punched into all input 
cards. 

3. All cards without a 1-punch in column 1 
are error cards and must be replaced by 
the operator . 
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T 




| Opera- 




| Instr 


j Name 
L _ 


| tion 
x 


Operand 
l _ _ 


j Sqnce 
_ j 


r — 


— t 


1 — 


1 


| REPT 


|GET 


CMBF, WRKC 


| (1) 




|CLI 


j WRKC,C 1' 


| (2) 




|BC 


8, NERR 


| (3) 




|GET 


| CMBF , WRKC 


| (4) 




| WAITC 




| (5) 




|HPR 


X'FFF' f 


| (6) 




|BC 


15, REPT 


| (7) 


| NERR 


1 • 








|PUI 


CMBF, WRKC 


| (8) 




| CRDPR 




| (9) 




|BC 


| 15, REPT 


| (10) 



L JL_ X J J 

Figure 52, Coding Example -- Programming 
with the WAITC Macro 
Instruction Involving Card 
Printing 



The sequence numbers shown in the 
rightmost cDlumn of Figure 52 are used as 
references in the explanations belotf. 



If the card that is made available by 
the normal SET (1) is not an error card, 
the next PUT for the same file (8) causes 
the preceding card to be printed on. If 
the card made available by the normal GET 
is an error card, the dummy GET (4) causes 
the error card to be moved past the punch 
station and the card preceding the error 
card is properly cardrprinted. On restart, 
the corrected error card is read by means 
of the normal GET (1), punched by means of 
the subsequent PUT (8), and card-printed at 
the time this PUT macro instruction is 
executed for the following card. 



The programming considerations that 
apply to card-printing, apply also to 
stacker-select CNTRL macro instructions 
without having a file name as the first 
operand. 



o 
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Appendix A. Approximate Main Storage 
Requirements of the IOCS Routines 



0\ 






The basic main storage requirement for all 
programs using the IOCS is 270 bytes. 
Additional main storage requirements depend 
on the IOCS features chosen and the 
input/output devices used. These 
requirements are listed in Figures 53 
through 55. The values shown in these 
charts can be used to calculate the 
approximate main storage requirements of 
the IOCS object program routines. 



Device 



Basic Rou- 
tines 



Printer 



2501 Card 
Reader 



2520 Card 
Punch 



2520 
Read 



Card 
Punch 



2560 MFCM 



1442, 
Model 
or 8 
Card 



5, 
Punch 



Model of Operation 



T 1 

Main | 

Storage 

Requirement 



Standard Carriage 



2203 with 
Dual-Feed Carriage 



Models Al and A2 
nonoverlap 



Model Al or A3 
overlap 



Model A2 
overlap 



nonoverlap 



overlap 



overlap 
combined 



If only one file 
is used (combined 
without card 
print) 



If two files are 
used (combined 
with card print) 



nonoverlap 



overlap 



270 



320 
680 



110 



160 



220 



100 
150 



750 



950 



1470 



100 
150 



Figure 53. Approximate IOCS Main Storage 
Requirements (in bytes) of the 
Routines for the Different 
Input/Output Devices 



Program 
Feature 



H 



Main Storage Requirements 



RFORMTn 

detail 

entry 



PFORMln 

detail 

entry 



SEQNCE 
detail 
entry 



I 

Basic l" 



For Each File 



H 



140* 



90* 



■+" 



Exit 
Entry 



14 J 



18 



No 

Exit Entry 



^ For 

Each 
Field 



MFCM, 2520 
36 



2501: 



24 



■+- 



MFCM, 2520: 
40 



-H 



+ _____ + 

2 4 bytes plus length 
of sequence field 



*14 bytes are required for the joint use 
of RFORMTn and PFORMTn detail entries. 

Figure 54. Approximate Main Storage 

Requirements (in bytes) oE 
Additional IOCS Features 



r r 

| | Main Storage 

I hacro Instruction (Requirement 



H 



■+- 



GET 



PUT 



1 I 



OPEN' 



CLOSE 



CRDPR 



CNTRL 



LOM 
EOM 



PR10V 
WAIT2 



Figure 55. Main Storage Requirements (in 
bytes) of Each Macro 
Instruction 
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Appendix B. Approximate Average Times Required 
for Generation and Execution of the IOCS Routines 



Figures 55 and 57 shew the approximate 
average times (in milliseconds) required 
for the execution of the various IOCS 
features and macro instructions. Figure 54 
shows the approximate times required for 



generation of the IOCS symbolic programs 
The generation time depends on (1) the 
device used to punch the IOCS symbolic 
deck, and (2) the machine configuration 
defined by the definition statements. 



O 



Device 



1403 Printer 



•+ 



2203 Printer 
Model Al 



2203 Printer 
Model A2 



2501 Card Reader, 
Models Al and A2 



2501 Card Reader, 
Model Al 



2501 Card Reader, 
Model A2 



2520 Card Punch 



1442 Card Punch, 
Model 5 



2520 Card Read 
Punch 



2560 Multi-Function 

Card Machine 
Model Al 



File Type 



simple 



simple 



standard | 
carriage | 

I- f 



simple 



j. f . 

dual-feed | 
carriage | 



simple 



f- 



simple 



-f- 



siraple 



-+- 



simple 



simple 



simple 



combined 



simple 



GE1 



Mode of \- 

Operation | lime Required 



standard | 
carriage | 



dual-feed | 
carriage | 



standard 
carriage 



-f- 



nonoverlap | 9 plus read time 



■f- 



overlap | 



12 



4- 



overlap j 
I 
■f- 



10 



nonoveriap | 



I— 



■+- 



4- 



overlap | 



nonoveriap | 
+- 



-f- 



overlap | 



nonoveriap | 12 plus read time 
j. + 

overlap j 13 



nonoveriap | 15 plus read time 



+- 

overlap j 



nonoveriap j 18 plus read time 
j. f 



overlap | 
+- 



20 



PUI 
Time Required 



12 



16 



15** 



24 



22.5 



-!- 



10 plus punch time 



11 



4- 



-+- 



8 plus punch time 



9 



"h 



14 plus punch feed time 



15 



20 plus punch time*| 



24* 



18 plus punch feed 
time. 



20 



combined 



2 8 plus punch time 
plus read time*-f 



igura 56. Approximate Average 
Part 1 of 2 



nonoveriap j 19 plus read time 
h + . _ 

(overlap j 20 

j j j 

limes Required by the GET and PUT Macro Instructions, 



28* 



o 



38 






Device 



2 560 Multi -Function 



Card Machine 



Model A2 



| Mode of 
File Type j Operation 



simple 



| nonoverlap 

1- - 

| overlap 

-+ 

| nonoverlap 



■+- 



GET 
riire Required 



pur 

Time Required 



27 plus read time |27 plus punch time 
f f ^ 

30 | 30 
__ + ^ 

28.5 plus read | 42 plus punch time 
time | 

combined j- -j- -j- -j 

overlap | 30 | 42 | 

l j j i j j 

♦PUT macros for combined files contain a punch and a read command. 
♦♦Value assuming alternate lower and upper carriage print operations. 
-j-If a GET follows a PUT for a combined file in nonoverlap mode, the GET and the 

PUT instructions require 28 msec plus punch time for 2520 and 35 msec plus punch 

and read time for 2560. 

Figura 56. Approximate Average rimes Required by the GET and PUT Macro Instructions, 
Part 2 of 2 



%jf 



© 



T 1 

msec per 10-Character 
Field to be Checked 



Program 
Feature 



RFORMTn | numeric 

detail j- ■ 

entry j blank 



PFORMTn 

detail 

entry 



Subm, 
2 



SEQNCE 

detail | 1.50 | 2.201 1.35 

entry 

5. 00 1 7. 50 | 4. 50 | minimum 
13.00 |19.50|11.70|maicimum 



4.00 
4.00 



Subm. 
3 or 

4 



t r 

Subm. 
5 



^ i 



+- 



6.00 
6.00 



3.60 



+- 



3.60 



f" 



• Figure 57. Approximate Average Times 

Required by the IOCS Features 



r ■ t 1 

j Unit(s) | | 

I Used for | Time Required j 
Generation j for Generation j 

j. _ + j 

| 2501 Card Reader | 4 to 6 minutes | 
| Model Al, and j | 

| 2520 Card Punch j | 

| Model A2 I j 

^ + _ j 

| 2560 MFCM Model Al | 6 to 12 minutes | 
|. + .j 

j 2560 MFCM Model A2 | 9 to 18 minutes j 

l . ± j 

Figure 5 8. Approximate Time Required for 
Generation of Symbolic IOCS 
Routines 
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Appendix C. Programming of User Routines 



c 



A user routine may be required in the main 
source program if certain checking 
functions (SEQNCE, RFORMT, or PFORMT) are 
desired. When the branch to a user routine 
occurs, the IOCS will automatically store 
the main program reentry address in general 
register 14. The routine must provide the 
linkage back to the main program. 

If the user routine contains any macro 
instruction (all macro instructions are 
permitted) , the contents of register 14 
should be saved before this macro 
instruction is executed. If this is not 
done, during execution of the macro 
instruction in the user routine the reentry 
address is lost. 



Operating System 
Systems. Since 
designed to supp 
that are unigue 
optimum performa 
macro instructio 
not identical to 
systems. Users 
from Model 20 to 
should therefore 
using the Model 
modification pri 
other systems. 



8K Input/Output Control 
the Model 20 IOCS is 
ort input/output devices 
to the Model 20 and achieve 
nee of all devices, some 
ns and DTFSR entries are 

those of the other 
who anticipate transition 

other models of System/3 6 

be aware that programs 
20' IOCS require 
or to generation by tne 



PROGRAMMING ERRORS 



If a PUT macro instruction is given that 
refers to a combined file and the program 
proceeds to the PFORMTn error routine 
(user's exit), a subsequent GET macro 
instruction will place the contents of tne 
card containing the PFORMT error into the 
work area. If this SET macro instruction 
is in nonoverlap mode, it is possinle to 
puncn this card by means of an additional 
PUT macro instruction. 



USE OF BASE REGISTERS 

Base register 15 is reserved for IOCS 
interrupt and macro routines. It must not 
be used by the programmer/ not even if he 
saves its contents between two macro 
instructions. 

Base register 14 is also used by the 
IOCS Eor all macro instructions. The 
programmer may use register 14 but does not 
have to save and restore its contents. 
nowever, the contents of the register will 
be changed during the execution of each 
macro instruction. 

Ivnen an IOCS-controlled brancn to a 
user-written routine (PFXI'I, RFXIT, or 
S2XIT) occurs and the user desires to issue 
an IOCS macro instruction in his routine, 
he must save the contents of register 14 
before the IOCS macro instruction is 
executed. He must restore the contents of 
register 14 to their original value before 
he returns control to the IOCS. 



LANGUAGE COMPATIBILITY 

Model 20 IOCS is closely patterned after 
the Basic Programming Support and Basic 



Programming errors can only be detected 
during phases 1 and 2 of a generation, that 
is, when the contents of the CTL card and 
the definition cards are read, loaded into 
main storage, and checked. 



A programming 
generate the spe 
punch or print a 
printer is not u 
run, the diagnos 
are punched into 
the incorrect de 
blank cards if t 
than one definit 



error prevents the IOCS to 
cified routines and to 

diagnostic message. If a 
sed during the generation 
tic messages — i£ any -- 

columns 1 through 10 of 
finition cards, or into 
he message refers to more 
ion card. 



Programming errors always cause a 
machine halt at the end of phase 3 of a 
generation, that is, when the checking of 
the definition statements has been 
completed. No programming-error halts can 
occur during the execution of phases 1 and 
2 of a generation run. 



CAUTION: If the programmer uses a macro 
instruction for which no IOCS routine has 
been generated due to a missing DTFSR 
detail entry, no diagnostic message is 
produced during the generation run. 
Example: The programmer has not included a 
CONTROL=YES detail entry in the DTFSR 
statement for a file and the program 
contains a ~NTRL macro instruction 
referring to this file. 



Diagnostic Messages 

The diagnostic messages that the IOCS 
produces upon detection of programming 
errors provide the programmer with an aid 
in identifying the errors. 
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Five types of programming errors are 
identified during phase 1 of a generation. 
Anotner seven types are detected in phase 2 
and identified daring phase 3 of a 
generation. Eacn Df these errors causes a 
diagnostic message to be printed or 
punched. The occurrence of one or more of 
these errors causes a machine halt upon 
completion of phase 3. 



Appendix ii contains a summary of the 
diagnostic messages produced during the 
Generation of IOCS routines. The 
subsequent text is a more detailed 
description of these diagnostic messages 
and their meaning. 



Messages Produced During Phase 3 

During phase 3 of a generation run, IOCS 
may produce the following diagnostic 
messages that refer to errors detected 
during phase 2. 

Message Meaning 

CARDBLKSZ The block-size specification of 
a card file exceeds 80, or is 
greater than 160 in case of read 
or punch binary. 

CRDPRREPTD Card printing is spaciEiad for 
both feeds of the 2560 MFCM. 

INCNSISTNT Two or more detail entries of a 
file contradict each othar, or 
at least one entry of a file is 
defined more than once. 






Messages Produced During Phase 1 

The following is a detailed description of 
the diagnostic messages produced during 
phase 1 and refers to errors detected 
during phase 1 of a generation. 



Message Mining 

COMMA A detail card eitner hao a 

continuation punch in column 72 
and no comma following the 
specification, or no 
continuation punch in column 72 
and a comma following the 
specification. 

KEYWORD The keyword in a detail card is 
not aligned in column 3 8, or is 
not followed by an equal sign 
(=) , or is not one of the 
permitted keywords. 

NUMBER A numeric specification contains 
nonnumeric character (s) , or 
exceeds the permissible limit. 

PARAMETER A keyword that requires a 

certain specification, or one of 
a number of prescribed 
specifications, is followed by 
an invalid specification. 

SYMBOL A name (or symbol) does not 
conform to the appropriate 
rules. 



INCOMPLETE A mandatory detail entry is 
missing . 

PRINTBLKSZ The sum of the block-size 

specifications of two print 
files for a printer with a 
dual- feed carriage exceeds 144; 
or the block-size specification 
of a file for a printer with a 
single- feed carriage exceeds 
144. 

PRlNTFILE One of the feeds of a printer 
with a dual-feed carriage nas 
been specified in the 
device- type entry of a file, 
while the other feed has not 
been assigned a file. 

REPEATED The device-type specification of 
a file contradicts the 
device-type specification of 
another file. 



RELATIVE ADDRESSING 

The programmer may desire to use relative 
addressing in routines of his program that 
include IOCS macro instructions . In this 
case, he must take into consideration the 
number of bytes required by the 
IOCS-generated instructions. Figura 5 5 
(Appendix A) shows the number of bytes that 
the generated instructions requira for aach 
of the macro instructions available to 
users of the I02S. 
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Appendix D. Sample Program 






This section contains a sample program that 
illustrates the use of the IOCS definition 
statements and macro instructions. 

The sample program is designed to 
perform an invoice billing application. 
The input to the program consists of: 

1. An invoice number and dane card 
containing the starting invoice number 
and today's date. 

2. Customer address cardo. 

3. Order cards containing tne order 
number, date of order, and customer 
number. 

4. Detail item cards specifying tne 
individual items ordered and customer 
number. 

From these input cards the program 
produces: 

1. An invoice for each customer. 

2. An invoice summary card for each 
customer. 

3. After all input cards have been 
processed, a new invoice-number and 
date card. 

In addition, the gross and net amounts 
for a particular item ordered are punched 
into that item's detail item card. 

The sample program is written for the 
following machine configuration: 

4,096 positions of main storage 
IBM 256 Multi-Function Card Machine 
IBM 2501 Card Reader 
One Printer. 



i.2E^t_Cards 

The input card formats are shown in Figures 
59 tnrough 62. Each type of input card tias 
an identification code punched in column 1 
for card-type identification purposes. The 
card types and their respective codes are: 

Code Card Types 

invoice number and date card 

1 customer address card 

2 order card 

3 detail item card 



The format of the invoices that will be 
printed by the program is shown in Figure 

63. Only the first invoice page for each 
customer will contain the customer name and 
address, customer number, invoice number, 
and today's date. Each successive page, 
except the last, will contain only order 
number, order date, and item entries. The 
invoice gross amount, the percent of 
discount, the net amount, and the mode of 
payment will be printed on the last invoice 
page for each customer . 

Invoice Summary Card 

An invoice summary card is punched and 
interpreted for each invoice printed. The 
format of this card type is shown in Figure 

64. A 4 will be punched in column 1 of 
each invoice summary card for card type 
identification purposes. 

tjew Invoice Number and Date Card 

After the last invoice has been prepared, 
the program punches a new invoice number 
and date card containing a in column 1 
and the beginning invoice number for tne 
next program run in columns 2-8. Columns 
11-16 (date field) are blank. 

R*23.IL&™_Data_Flow 

Figure 65 shows the flow of data for the 
sample program. 

The sample program was written with the 
following assumptions: 

1. The invoice number and date card will 
be the first card read from hopper 1 of 
the MFCM. 

2. The customer address file contains an 
address card for each customer. The 
file is assumed to be in ascending 
sequence according to customer number. 
A sequence check will be performed on 
this file. 

3. Each order card contains an order 
number and date and is followed by at 
least one detail item card. The 
customer number in each detail card is 
assumed to equal the numoer in the 
preceding order card. This file ib 
assumed to be in sequence according to 
customer number and will not be 
sequence checked. 
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First 

Invoice 

Number 



Today's 
Date 



000000 

111111 

22222? 
3 33331 
<<<<<< 
555555 
(6 66(6 

mm 

088888 
99 9999 



Blank 



0000000 000000 

t II II 77 71 II 71 71 7r 71 71 

1111111111111 
2222222 222222 
1 J33 3 33 33 3 33 3 
<«<<<<<<<«<<< 
5555555555555 
(((((66(6 6(66 
7777777777777 



00000000000000 

1' 17 11 1* 1) » 1' II )t 4 It *7 II I! 
11111111111111 

2222222222 2222 
3 3 3 33 3 3 3333 3 33 

5 55 55555555555 

6 6 6 6 6 6 6 6 6 6 6 6 6 6 

7 7 7 7 7 7 7 7777777 



oooooooooooooooooooooooooooooooooo 

17 II II M II 17 II M » X 17 II H H II « II M II « II U II 71 l< 71 71 II 71 II II II II N 

1111111111111111111111111111111111 

2222222222 222222222222222222222222 
33333 33333 J33333J3333 3333333333333 

<««<<<<<<<<♦<<«<<<«<«<<<<<<<**<<<< 
5555555555 555 555555555555555555555 
666(6666666(((((((6(((((6(6(66(((6 
7777777777777777777777777777777777 



88888888888888888888 88888888888888888886 888888888888888888888888 

II H II II |i n II 71 71 H 7111 71 M l< II II U II II II II II W <l II II u II II » II II II II » 11 M i! Si II II II H II « II V II II I' II II II I' I' 'I " » >■ " 7 

99999999999999999999999999«9999999999999999999999999999999999999 



Figurs 59. Invoice Summary and Date Card Format 



A 



o 



T Customer 
Number 



Customer Name 



00000 

1111 

2222 
3 33 3 
< < << 
5555 
((( ( 
7777 
8888 

H ii 17 II 

9999 



0000 
1111 
2222 
13 3 3 
< < < « 
5555 
(666 
7777 
8888 
9999 



0000000000 

'I II II II 77 71 71 71 II 71 
1111111111 

2222222222 
313 3 3 3 333 3 

mnnm 
5555555555 
(((6 666666 
7777 777777 
8888888888 

« » II 71 77 II I" 71 H 77 

999 9 999 99 9 



Street Address 



00000000.000 

II II I) » 17 ]l II II II 17 I] 

11111111111 



22222222222 
33 3 3 3 3 J3333 

<<< <.<<<«< «< 

55555555555 
66 666 66(666 
7 7 7 7 7777777 
888888888888888 
99 9 9999999999 99 



City and State 



00000000000000000000000000 

II H II II II H II II II H II H II I! II H II K II U H II 7 
11111111111111111111111111 

222222222 22222222222222222 
3313 33 313 3333133 33 33 33 333 3 

«<<4 <<<<<<<<<««<<<<<<<<«< < 
555555555 55555555555555555 
(66 6 6(6 66 6(6(6 6 6 6 6 6 6 6 66(66 
77777777777777777777777777 
8888838888888888888(88 8 8 88 

II II II 17 II SI \i ii SI M II H I' 17 II II IS H II II II II I 

99999999999999999995999999 



Mode of 
Payment 



Blank 



00000 

11111 

22222 
33 333 

nm 

55555 
(6666 
7 7777 
88888 
9 9999 



Figure 60. Customer Address Card Format 



Customer 
Number 



Order 
Number 



Order 
date 



Blank 



00000 

11111 

22222 
11111 

m u 

55555 
66(66 
77777 
88888 
9999 9 



0000000000000000000 

n|ll 71 77 tl 71 71 II 77 71 71 II )< II II 14 II » II II 
1111111111111111111 

222 2232222222222222 
1111113 3 3 3 3 3 3 3 313 3 3 

ammmmum 

5555555555555555555 
666 ((((66(66(666666 
7777777777777777777 



00000000 


» II II 41 1] 41 41 41 


11111111 


22222222 


33333311 


umm 


55555555 


66666666 


77777777 



0.000000000000 

4? «l 41 M II If 1] 14 II 14 II U 11 U II U U M II M 

11111111111111111111 

2 2 22 222 227 22222 22 222 
113133333 3 3333133331 

nmmmmnnn 

55555555555555555555 
66666666666666666666 

77777777777777777777 



88888888868888888880888888888888888888888888888 

II 1< 77 11 II 71 » 17 71 II H II II 1] II 11 II i: II 11 II 41 II 4] 44 II II l> II II II H 17 SI 14 11 '.I i ' il II H II II II 14 II K 

999 9999999999999999999999 999 999 99999999999 99 999 



000000000000 

II II II 17 71 II IS 71 71 71 71 II 
111111111111 

22222222 2222 
3 3 333333 3113 

mmmm 

55 5555555555 
666666666666 

7 7 7 777 7 7 7777 
8888888888888 

II II II li 17 II II 'I II II II II II 

9 99 9999999 999 



O 



Figure 61. Order Card Format 
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A 



TOustamer Net 



I Number 



ooooop 



Amount 



000000000 

1111111 



2222 

nn 

5 5 55 

6 666 

7 7 77 



8888888 
9 9 99 999 



Gross 
Amount 



Item 
Number 



0-0 

» ;; 71 » M ji 

1 11 1.1 1 1 



222222 

3 3 3333} 

<<<♦<<< 

5555555 

6666(66 

7 777777 

8888888 
i n » ii H 
9999999 



Blank 



00000000 

H JI » II 3' 31 31 M 

11111111 



72222222 
3 333 33)3 
*«<<<<<< 
55555555 
66666666 
77777 777 
88888888 
99999 999 



Item Name 



Blank 



Qty. 



Blank 



Unit 
r>fce 



000 00000 0000 00 000 000000000 00000 

II II M 13 « II II It H 11 11 31 M 33 X 11 II II H II II 13 M « M II U II II II II 

111111111111111111111111111111111 

2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 
33333 33333333 33 3333333333 33333333 

<<<<<<<< 4 < 4 4 <<<<< 4 << 4 <•*<<<<<<<<< < 
5555555555555 55 5555555 55555555555 
66666666666666666666666666666666 6|6 
7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7|7 
888888888888868888888888888888888 

II I' II II II It 1? 11 II 11 H 1' 31 31 H II II II II II M II » II 

99«999999999999999999999999999999 



0000000 

ii n ii » ii n 
111111 

222222 

33 33 33 

<<<<♦< 

55555! 
6666I 
7 7 7 7; 

888881 

999 9 9 



55 



88 






Figure 62. Detail Item Card Format 
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Hopper 1 of the MFCM contains an 
invoice number and date card, order 
cards, and detail item cards only. 

Hopper 2 of the MFCM contains only 
blank cards. 



sumnary cards. Note the use of the CRDPRLn 
entries to specify the print heads. 



The file named ADDR contains the 
customer address cards. 



o 



Definition Statements 

Figure 66 shows the definition statements 
required to generate the IOCS routines for 
this program. A.11 input/output devices 
will operate in the overlap mode. 

The file named ORDR is a combined file 
because the detail item cards must be read 
and punched. Note the RFORMTO, and RFXI1 
entries. The RFORMrO entry specifies a 
check of columns 8-25 of each card to be 
punched to ensure that they are blank. The 
RFXIT specifies that the user routine named 
PCHF is to be executed when columns 8-25 of 
a card to be punched are not blank. The 
PCHF routine selects the detail item card 
with punching in columns 8-25 and all 
following cards for the current customer 
into Stacker 3. 

ine file named ISUM is composed of the 
blank cards that will become the invoice 



The invoice file which will be printed 
on the printer is named PRIN. 



Program Flowchart and Coding 

Figure 6 7 shows a flow chart for the nain 
program and Figure 6 8 shows the main 
program coding in Model 20 Basic Assembler 
language. 

The program was written assuming joint 
assembly. Each of the macro instructions 
shown in the program coding specifies the 
name of the work area to he used during the 
input/output operation. Some of the work 
areas are used for more than one file. For 
example, at one point in the program, a 
portion of the area named AR4 is used to 
contain data to be punched in a detail-item 
card and at a later point the same portion 
of A.R4 is used to contain the data to oe 
printed on the invoice. 
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Figure 66. Sample Program Definition Statements, Part 1 of 2 
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Figure 68. Sample Program Coding, Part 1 of 8 
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Appendix E. Summary of Diagnostic Messages 



^H^j|p 



Message j Meaning 

_ _ _ _j. _ _ _ _ ■ _ _____ 


_ _ _ _^. _ ___ ______ ___ 

CARDBLK3Z | BLKSIZE specification of card file exceeds 80 (or 160 if raad or 

j punch binary) . 

±_ _ _ _ _ _ 


.j.- _ — _ _ _ _ _ _ _ 

COMMA | comma after detail entry but no continuation punch in col. 72, or 

j no comma but punch in col. 72. 

_ j _ _ _ _ 


_ -| _ _ _ — _ 

CRDPRREPrD | card printing specified for both feeds of 2560 MFCM. 

_ _ _±. _ _ _ 


_ _ — _ _.j- _ _ _ _ _ — _ — 

INCNSISTNT | two or more detail entries of a file contradict each other, or at 

(least one entry of a file is defined more than once. 

_j _ _ 


_ _ _.| _ _ _ — _ — 

INCOMPLETE | mandatory detail entry missing. 

_ _j_ _ _ _ _ _ _ _ _ 


_ _.j- _ _ _ _ _ — _ _ _ _ _ 

KEYWORD | keyword not aligned in column 3 8, or not followed by equal sign, or 

j invalid. 
_ __J-_ _ ____ 


- ~-T - ____ ___ 

NUMBER | numeric specification invalid. 

1 _ 

PARAMETER | specif ication invalid. 

_j _ ■_ _ _ _ _ 


_ .j- _ _ — _ _ _ _ _ _ _ 

PRINIBLKSZ | dual-feed carriage — sum of BLKSIZE specifications exceeds 144; 

j single-feed carriage — BLKSIZE specification exceeds 144. 

j. ___ _ ___ _ 


T ■ 

PRINTF.ILE | one feed of printer with dual-feed carriage has not been assigned a 

| file. 

_ _ _ _ x_ _' ___ _____ 


_ — -f— _ ___ _____ — 

REPEATED | device-type specifications of two files contradict each other. 

■_ _ _ _ 'j __ _ ___ _ _ 


T ___ _ _ 

SYMBOL | symbolic name invalid. 
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